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PREFACE 


This publication describes the Device Support Facilities 
processor and commands. It also discusses hardware 
considerations, operating system considerations, and planning 
and installation. It 18 written for installation managers. 
system programmers, system operators, and other data processing 
Personnel who manage or use direct access storage devices 
CDASD). 


Wherever an IBM operating system is discussed, it is assumed 
readers understand the concepts and terms used in that operating 
system. 


MAJOR DIVISIONS OF THIS PUBLICATION 


For convenience, information on Device Support Facilities 15 
presented under two major headings: 


® "Part 1. General Information™ describes Device Support 
Facilities and how it is used by the system programmer and 
the system operator. 


® WPart 2. Reference Information" describes in detail the 
syntax and function of the Device Support Facilities 
commands. 


Appendix A contains description and figures showing volume 
layout anc record formats. Appendix B describes support for the 
minidisk under VM/370. Appendix C lists and explains Davice 
Support Facilities messages. Appendix D contains problem 
detarmination information. Appendix E describes the VTOC index, 
and gives information on calculating the size af the index data 
set. Appendix F describes the fixed block architecture VTOC 
CFBAVTOC) and gives infermation on calculating the FBAVTOC space 
requirements. Appendix G describes the device surface analysis 
performed by Device Support facilities. 


CONVENTIONS USED IN TRIS PUBLICATION 
The illustrations of command formats in this book use the 
following conventions: 
e Brackets (£]) indicate an optional field or parameter. 


® Braces ({}}) indicate that one of alternative items must be 
selected. 


® Items separated by a vertical bar (|) represent alternative 
items. Only one item may be selected. 


° An ellipsis (€*e¢e) indicates that multiple antries of the 
type immediately preceding the ellipsis are allowad. 


® Boldface type indicates the exact characters to be entered. 
Such items must be entered as shown or in the abdbreviated 
form allowed. 


« Underscored uppercase type indicates a default option. If 
the parameter 1s omitted, the default value is assumed. 


® Underscored lowercase or lowercase type indicates fields to 
be supplied by you. 
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PRERE 


QUISITE PUBLICATIONS 


Parentheses, commas, slashes, spaces, and other punctuation 
must be entered as shown. 


Numeric parameters can be coded in two ways: decimal or 
hexadecimal CX'n'). This applies to any parameter that 
specifies a substitution of decimal numbers. 


Character string parameters can be coded either with or 
without enclosing them in single quotation marks. However, 
if delimiters such as commas, blanks, or parentheses appear 
within a character string, the string must be enclosed 
Within single quotation marks. 


IBM System/370 and 4300 Processors Bibliography, GC20-0001, 


describes the publications that are applicable and current for 
OS/VS and DOS/VSE operating systems. 


RELATED PUBLICATIONS 


Other books that may be helpful to you are: 


Device Support Facilities Logic, SY35-0030, describes the 
program logic of Device Support Facilities. 


Se ed ar ar ee 


Operator's Library: IBM 3850 Mass Storage System (MSS) 
Under O05/7VS, GC35-0014%, describes commands used with the 
Mass Storage System. 


Data Facility Device Support: User's Guide and Reference, 
S$C26-3952, describes the index to the table of contents 


C(VTOC) and tells how the index is created and used. 


OS/VS2 MVS Resource Access Control Facility CRACF) General 
Information Manual, GC28-0722, describes the functions and 
capabilities of access control. 


OS/VS2 System Programming Library: Supervisor, GC28-0628, 
describes the authorized program facility and service 


management CSRB dispatching). 


Component Summary——-1835 Storage Control, 2305 Fixed Head 
storage, GA26-1589, describes the 2305 direct access storage 
device, 


IBM System 360-——Component Descriptions, 2314 Direct Access 


Storace Facility and 2844 Auxiliary Storage Control, 
GA26-3599, describes the 2314 direct access storage device. 


IBM 2319 Disk Storage-——A Series, Component Description, 
GA26-1606, dascribes the 2319 direct access storage device. 


IBM 3310 Direct Access Storage Reference Manual, GA26-1660, 
describes the 3310 fixed block storage device. 


Reference Manual for IBM 3330, A Series, Disk Storage, 
GA26-1615, describes the 3330 direct access storage devices, 


Reference Manual for IBM 3340-3344 Disk Storage, GA26-1619, 
describes the 3340 and 3344 direct access storage devices. 
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Reference Manual for IBM 3350 Direct Access Storage, 
GA26-1638, describes the 3350 direct access storage device. 


Introduction to IBM 3370 Direct Access Storage, GA26-1657, 
describes the 3370 storage system and its fixed block data 
format. 


Introduction to 3375 Direct Access Storage, GA26-1666, 
describes the 3375 direct access storage device. 


IBM 3380 Direct Access Storage Description and User's Guide, 
GA26-16646, describes the 3380 direct access storage device. 
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SUMMARY 


| RELEASE 5.0 


| NEN SUPPORT 


| MACRO CHANGES 


| OTHER CHANGES 


RELEASE 4.0 


NEW 


Vj 


SUPPORT 


OF AMENDMENTS 


The IBM 3310 and 3370 fixed block architecture CFBA) devices are 
now supported by the INIT, INSPECT, and REFORMAT commands. This 
support 15 available in the DOS/VSE and stand-alone 
environments. The INIT command allows you to initialize the 3310 
and 3370 at minimal and maximal levels. The INSPECT command 
supports surface analysis and alternate block assignment. 
REFORMAT allows the volume serial and volume owner in the volume 
label to be updated. 


The INIT command now supports 3310 and 3370 minidisks at the 
minimal level. This support initializes the volume labels and 
the FBA VTOC. No surface checking or alternate block assignment 
16 supported. 3310 and 3370 minidisk support is valid in the 
stand-alone environment only. See "Appendix B. Minidisk 
Support™ on page $5 for datails of minidisk support. 


.- The 3310 and 3370 FBA volumes can be used by the INIT, INSPECT, 


and REFORMAT commands. 


A new parameter FBAVTOC has been added to the INIT command. 
FBAVTOC allows you to specify the starting location, size, and 
control interval size of an FBA VTOC. 


"Appendix F. The Fixed Block Architecture VTOC (FBAVTOC)" has 
bean added. 


"Appendix G. Surface Analysis™ has been added. 


Updates have been made throughout "Appendix C. Device Support 
Facilities Messages (CICK)." 


The IBM 3375 is now supported in the stand-alone, OS/VSI1, and 
OS/VS2 MVS environments. 


For the IBM 3375 and 3380, skip displacement can now be 
performed. Device Support Facilities will skip over defects ona 
track in lieu of assigning an alternate track. Skip displacement 
1S performed by the INIT command at the maximal level if an 
error is encountered, and by the INSPECT command when you 
specify CHECK with TRACKS. 
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CHANGES TO COMMANDS 


OTHER CHANGES 


The DEVICETYPE parameter has been deleted from the ANALYZE, 
MAPALT, and REFORMAT commands. With the INIT and INSPECT 
commands, the DEVICETYPE parameter 15 only required when you use 
these commands with the MIMICCMINI)D or MIMICCEMU) option. 


In the stand-alone environment, you can identify the input 
and/or output device to ICKDSF by specifying CARD or PRNT 
instead of the actual device. ICKDSF then selects the 
appropriate input and/or output device respectively. 


Updates have been made throughout “Appendix C. Device Support 
Facilities Messages CICK)" on page 96. 


Editorial updates have been made throughout. 
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Part 1. 


General Information 


GENERAL INFORMATION 


1 


INTRODUCTION 


Device Support Facilities is a program used with IBM System/370 
operating systems to perform various operations on direct-access 
storage devices. It can initialize a direct-access storage 
volume so that 1t can be used in an OS/VS or a DOS/VSE system, 
inspect a volume for defective tracks, reformat the volume label 
and IPL bootstrap and program records, and examine a davice with 


a nonremovable storage mechanism to determine if there are 
problems with the drive or with reading or writing data stored — 
on the volume. 


Device Support Facilities operates under OS/VS1, OS/VS2 MVS, and 
and as a stand-alone program under a native or VM/370 
virtual machine environment. 


DOS/VSE, 


Device Support Facilties supports the following devices: 


° 2305 
° 2311 
® 2314 
° 2313 
e go 10 
° 3330 
° 3330 


Fixed Head Storage Models 1l and 2 (2305-1, 


Disk Storage Model 1 (2311) 


2305-2) 


Direct Access Storage Facility (2314) 


Disk Storage Models Al, A2, and A3 (€2319) 


Direct Access Storage (3310) 


Disk Storage Models 1 and 2 (3330) 


Disk Storage Model 11 (3330-11) 
® 3330V MSS 3330 Virtual Volume 
© 3333 Disk Storage and Control Models 1 and 11 (33530, 


3330-11) 
e 3340 Direct Access Storage Facility (3340) 
° 3344 Direct Access Storage (3344) 
e 3350 Direct Access Storage (3350) 
e 3370 Direct Access Storage (3370) 
° 3375 Direct Access Storage (3375) 
© 3380 Direct Access Storage (3380) 


See Figure 2 for information on devices supported by specific 
Device Support Facilities commands. 
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2 


The surface analysis functions performed by Device Support 
Facilities are not equivalent to the surface analysis which is 
performed on a volume at the factory. 


Marginal defects that exist on the surface of a track cannot be 
detected consistently by Device Support Facilities because of 


their 


intermittent nature. 


Therefore, 


different results can be 


obtained for the same track and/or volume from multiple runs of 


Device Support Facilities. 


Also, 


Device Support Facilities 


output can differ from other surface analysis products because 


of different surface checking algorithms. 


See "Appendix G. 


Surface Analysis" for more information on surface analysis. 
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| DETERMINING THE LEVEL OF YOUR DEVICE SUPPORT FACILITIES 


To check that the level of your documentation matches the level 
of your code, Device Support Facilities displays the code level 
at the top line of each page that 1s printed on the output 
device. The top line 1s printed as follows: 


| ICKDSF-xxx DEVICE SUPPORT FACILITIES yyy 
| where: 


Xxxx=VS1 

¥S2 

DOS 

SAC stand alone) 
yyy-Release (for example, 4.0) 


INSTALLATION INFORMATION 


Instructions explaining how to install Device Support Facilities 
are contained in the program directory shipped with the 
machine-readable material. 


STORAGE REQUIREMENTS 


Device Support Facilities requires the following estimated 
amounts of storage space: 


Main storage: 384K bytes 


| OS/V51 and oS/VSe MVS 
Auxiliary storage: 200K bytes 


| DOS/SVSE 
Minimum partition size of 384K bytes 


For all devices except 3375 and 3380, 332K bytes are 


| Stand Alene 
required. For the 3375 and 35380, 384K bytes are required. 


| FIXED BLOCK ARCHITECTURE DEVICES 


Where the term fixed block architecture is used in this book, it 
refers to the following devices: 


| « 3310 
| « 3370 


DEVICE SUPPORT FACILITIES COMMANDS 


Device Support Facilities has six commands, ANALYZE, BUILDIX, 
INIT, INSPECT, MAPALT, and REFORMAT. The ANALYZE, INIT, INSPECT, 
and REFORMAT commands are used with both fixed block 
architecture and count key data devices. Tne BUILDIX command is 
used with count key data devices. The MAPALT command is used 
with fixed block architecture devices. 


° ANALYZE is used for nonremovable storage media to determine 


if there are any problems with the drive or with reading the 
user data recorded on the volume. 


Introduction 3 


e BUILDIX changes a standard OS format VTOC to an indexed 
VTOC, or it can change an indexed VTOC to an OS/VS VTOC. 


e INIT initializes a direct~access storage volume so that it 
| can be used in an operating system environment or it 
) reinitializes a volume that was previously initialized. 


@ INSPECT inspects a previously initialized volume for 
| defective blocks or tracks. 
® - MAPALT produces a report showing the assignment of primary 
blocks to alternate blocks on fixed block architecture 
devices. 
e REFORMAT reformats a previously initialized volume. For 


count key data devices, the volume label, IPL bootstrap, and 
IPL program records are reformatted. For fixed block 
architecture devices, the volume label is reformatted. 


Figure 1 displays these commands and indicates the operating 
systems each command supports. 


Figure 2 displays the commands and indicates the devices each 
command supports. It also indicates which devices have fixed 
block architecture (FBA). In both figures, an X denotes support 
and a hyphen (-) denotes nonsupport. Sections following the 
figures give an overview of the commands. 


ANALYZE BUILDIX INIT INSP MAPALT  REMT 
STAND/ALONE X | X 
X 


DOS/VSE x 
VS/1 x - 
MVS x | 


Figure 1. Operating Systems Supported by ICKDSF Commands 


ANALYZE BUILDIX INIT INSP MAPALT RFMT 


2305 
2311 
2314 
2319 
3310 [FBA] 4 
; 3330-1 Emulated 
3330-11 Emulated 
3330V - 
3333 Emulated 
3340 Emulated 
3344 
3350 
| 3370 [FBA] 
3375 
3380 


{i tf 


2K OK DK OOK OK OK DK OK OK OS OK OK OK OK OK 
MK OK DK OOK OK OOK OK OK OKOKER OK OOK OK OK 
Pex tet t ttuimbiteet 
>< OK KEK OK OK OOK OK OK OK OK OK OOK 


MK LK KKK KOK OK EEK 


mM MK HK OK OK 


Figure 2. Devices Supported by ICKDSF Commands 
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Note that the following devices are supported only in certain 
environments: 


© The 2311, 3310, and 3370 are supported by DOS/VSE and 
stand-alone. 


e The 2395 18s supported by OQS/VS1, OS/VS2 MVS, and 
stand-alone. 


® The 3330 MSS virtual volume €3330V) is Supported by the INIT 
command in a stand-alone environment when the MIMICCMINI) 
parameter 185 also specified. The 3330V is also supported by 
the BUILDIX command in the OS/VS1 and OS/VS2 MVS 
environments. 


® The 3375 is supported by OS/VS1, OS/VS2 MVS, and 
stand-alone. 


© The 3380 1s supported by OS/VS2 MVS and stand-alone. 


CONSIDERATIONS FOR STAGING DEVICES 


Before Device Support Facilities can be run against a staging 
device, and before the drive can be accessed, the device must be 
in offline real status. See the manual Operator's Library: IBM 
3850 Mass Storage System (NSS) Under OS/VS for details of the 
VARY OFFLINE, TEST command that is used to set up the device for 
nonstaging access. 


ANALYZING A VOLUME WITH NONREMOVARLE STORAGE MEDIA 


When error messages indicate a problem with a DASD davice having 
nonremovable storage media, the ANALYZE command can help the 
user determine whether to continue operating the device or to 
start the installation's recovery procedures. 


Examples of messages that indicate equipment or data problems 
are: 


® In an O0S/VS system: 

A supervisor message such as IEAO00I 
° In a DOS/VSE system: 

A DASD error message such as 8121 I 


ANALYZE is used in an OS/VS or DOS/VSE operating system, or in 
the stand-alone environment, to examine the storage device to 
determine if there are drive problems or storage media problems. 
A drive problem is an equipment failure within the device that 
prevents data from being written correctly on the storage media 
or from being read correctly once it has been written. A storage 
media problem is a failure on the magnetic surface of the 
davice's disk-~-some of the data can be written and read 
correctly, other data on the same surface cannot. 


ANALYZE examines the device and, based on the sense information 
returned, determines the type of problem. It then issues the 
appropriate message. 


If ANALYZE does not detect a problem and you continue to have 
errors in the data read from the drive, you may assume that the 
condition is either intermittent or results from incorrect data 
or faulty programming. 
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Note that ANALYZE helps determine if recovery actions are 
needed, but does not initiate recovery procedures to repair the 
drive or its data. It is expected that the user's own data 
backup and recovery strategy will be provided. 


In OS/VS systems having indexed VTOC programming support, the 
BUILDIX command can be used to change a standard OS format VTOC 
on a count key data device to a VTOC with an indexed format. 
(The abbreviations OSVTOC and IXVTOC, when used in this book, 
refer to these two formats of the VTOC. These abbreviations are 
also used in system messages and to designate parameters of the 


BUILDIX command.) 

The BUILDIX command is used to: 

e Change an OS format VTOC to an indexed VTOC 
e Change tne indexed VTOC to an 0S format VTOC 


"Appendix E. The VTOC Index" on page 157 contains more 
information about indexed format VTOCs. 


INITIALIZING A VOLUME 


The INIT command can be used to initialize a direct-access 
storage volume so that it can be used in an OS/VS or DOS/VSE 
| operating system. Initialization can be at a minimal, medial, or 
maximal level depending on the device being initialized and the 
| command parameters you specify. Command parameters are discussed 
in detail in "Part 2. Reference Information." 


The INIT command is used to: 


e Check the block or track surfaces and assign alternates to 
defective blocks or tracks 


| « Reclaim blocks or tracks that were previously flagged 
defactive if the results of surface checking show there are 
no recording errors 


® Write a volume label and reserve space for additional user 
| voluma~label records 


® Write a volume serial number in the volume label 
@ Write an owner identification in the volume label 


° Initialize a volume table of contents (VTOC) and reserve 
space for additional entrias 


* Write IPL bootstrap records and an IPL program (count key 
data devices only) 


° Validate the home address and record 0 for each track (count 
key data devices only) 


e Write an index for the VTOC mentioned above, thereby 
creating an indexed VTOC Ccount key data devices only). 
WAppandix E. The VTOC Index" on page 157 contains more 
information about indexed format VTOCs. 
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INSPECTING &A VOLUNE 


After initializing a volume, you can use the INSPECT command to 
inspect a volume for defective blocks or tracks, to assign 
alternate blocks or tracks, or to reclaim tracks that were 
previously flagged defective. 


The INSPECT command is used to: 


e Conditionally assign alternate blocks or tracks based on the 
results of surface checks 

e Unconditionally assign alternate blocks or tracks 

e Conditionally reclaim primary or alternate tracks 

° Conditionally reassign alternate blocks or tracks based on 


results of surface check 


® Unconditionally reassign alternate blocks or tracks 


MAPPING ALTERNATE BLOCK ASSIGNMENTS 


REFORMATTING A 


In a DOS/VSE operating system or in the stand-alone environment, 
the MAPALT command can be used on fixed block architecture 
direct access storage devices to produce a printed report, or 
map, showing primary blocks on the device that have alternate 
blocks assigned. A limited range of blocks to be mapped may be 
specified, if desired. | | : 


MAPALT output includes: 


e A summary report showing the number of blocks with 
alternates assigned. 


® An optional detailed report showing the relative block 
number of the defective primary block, its location on the 
volume, and the location on the volume af the assigned 
alternate. 


© Diagnostic information, if I/0 errors cause interruption of 
program execution 


VOLUME 


After a volume has been initialized, the REFORMAT command can be 
used to change the volume serial number, owner identification, 
and IPL bootstrap and program records. Also, if an IPL program 
record does not already axist on the volume, one can be added. 
Only volumes that have been initialized can be reformatted. 


The REFORMAT command is used to: 


e Write a new volume serial number in the volume label 
® Write a new owner identification in the volume label 
e For count key data devices, write IPL bootstrap records at 


cylinder 0, track 0, records 1 and 2, and replace or add an 
IPL program 
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DATA SET SECURITY AND PROTECTION 


Device Support Facilities commands are used to manage 
direact-access storage volumes. There is danger of serious damage 
to data through inadvertent manipulation of a volume. For this 
reason, it is important to have some means of protecting data. 
With Device Support Facilities there are several degrees of 
volume and data set protection. 


There are two environments in which Device Support Facilities 
can execute: in an operating system or ina stand-alone 
environment. In the OS/VS operating systems, two modes of - 
operation are available: offline and online. In a stand-alone 
environment, only the offline mode is available. In a DOS/VSE 
environment, only the online mode is available. Data set 
security and protection in different environments and with 
different modes of operation are aieereeee in the following 
SAE t GAS. 


Note that the ANALYZE command does not expose data on the volume 
to unauthorized disclosure, modification, or destruction, since 
the: ANALYZE command does not write on any user data tracks and 
does not transmit any user data from the device under test. 


DATA SET SECURITY AND PROTECTION IN AN OFFLINE MODE (OS/VS) OR IN A STAND-ALONE 
ENVIRONMENT 


Data set security and protection are limited in offline mode or 
in a stand-alone environment to what is indicated below: 


e The VERIFY parameter of the INIT, INSPECT, and REFORMAT 
commands can be specified to ensure that the volume serial 
number and cwner identification supplied in the command 
match those found on the volume. If they match, execution of 
the command continues; if they do not match, execution of 
the command terminates. | 


¢ The PURGE parameter of the INIT command can be specified. 
Before the command starts processing the volume, the 
operator is requested to confirm that the contents of the 
volume can be purged (see message ICKO03D in “Appendix C. 
Device Support Facilities Messages"). If the operator 
confirms that the volume contents can be purged, they are 
purged without consideration as to whether the data is 
contained in unexpired data sets, VSAM data sets, 
password-protected data sets, or RACF-protected data sets. 


DATA SET SECURITY AND PROTECTION IN AN ONLINE MODE (OS/VS) 


Because the resources of the operating system are available to 
Device Support Facilities in an online mode, data set security 
and protection are greater. 


The VERIFY parameter of the INIT, INSPECT, and REFORMAT commands 
can be specified to ensure that the volume serial number and 
owner identification supplied in the command match those found 
on the volume. If they match, execution of the command 
continues; if they do not match, execution of the command 
tarminates. The VERIFY parameter causes the same result in 
either online or offline mode COS/VS environment) or ina 
stand-alone environment. 


The NOPURGE parameter of the INIT command can be specified. 
Execution of the command terminates if unexpired data sets, 
password-protected data sets, RACF-protected data sets, or VSAM 
data sets are found on the volume. 
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The PURGE parameter of the INIT command or the NOPRESERVE 
parameter of the INSPECT command can be specified. If unexpired 
data sets, password-protected data sets, RACF-protected data 
sets, or VSAM data sets are on the volume, data loss is 
prevented as follows: | : 


° Unexpired data sets: The operator is requested to confirm 
that the contents of the volume can be purged (see message 
ICKO01D in “Appendix C. Device Support Facilities 
Messages"). Only one request is made, regardless of the 
number of unexpired data sets on the volume. Note that a 
list of the unexpired data sets is not provided. 


° Password-protected data sets: The operator must provide the 
correct password for each password-protected data sat on the 
volume. If the correct password is not supplied, execution 
of the command terminates. Note that a data set that is 
rassword-protected and unexpired will be purged if the 
Password is supplied, even though the expiration date has 
not been passed. If a data set is RACF-protected and 
password-protected, the data seat password is bypassed, and 
only RACF protection 15 provided. 


Because of the number of requests for passwords, it may be 
less time-consuming to process the volume ona device that 
1s offline to the operating system. 


e RACF-protected data sets: The RACF program determines if 
the user 15 authorized to access the volume contents. When 
the user 1s authorized for full volume access, the command 
continues processing. If the user is not so authorized, the 
command terminates unless the user has authority to access 
data sats. If the user has data set authorization, the RACF 
program determines for each data set whether the user is 
authorized to scratch the data set. If so, thea command is 
executed. Should any data set be found that the user is not 
authorized to scratch, execution of the command terminates. 
If a data set is both RACF protected and password protected, 
the password will be checked only if RACF support is not 
present tn the system. The system operator usually has the 
authority to bypass RACF checking. 


* VSAM data sets: In the online mode, when VSAM data sets 
exist on the volume, processing terminates and a message is 
issued. If this volume is to be reinitialized, it is 
necessary to do so in the offline mode. 


AUTHORIZED PROGRAM FACILITY (OS/VS2 MVS ONLY) 


The authorized program facility CAPF) limits the use of 
sensitive system services and resources to authorized system and 
user programs. See "Authorized Program Facility CAPF)"™ in OS/VS2 


System Programming Library: Supervisor for information about 
program authorization. 


The Device Support Facilities load module is contained in 
SYS1.LINKLIB, except module ICKDV05 CIGGO19P2), which is 
contained in SYSI1.SVCLIB. The load module CICKDSF) is 
link-edited with the SETCODE ACC1) attribute. These two 
characteristics ensure that Device Support Facilities executes 
With Authorized Program Facility authorization. 


This authorization is established at the task level. If, during 
the execution of an APF-authorized job step, a load request is 
satisfied from an unauthorized library, the task will be 
abnormally terminated. It is the installation's responsibility 
to ensure that a load request cannot be satisfied from an 
unauthorized library during Device Support Facilities 
processing. 
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If a Davice Support Facilities module is loaded from an 
unauthorized library, the Authorized Program Facility 
authorization of Device Support Facilities terminates. 


DATA SET SECURITY AND PROTECTION (DOS/VSE) 


The VERIFY parameter of the INIT, INSPECT, and REFORMAT commands 
can be specified to ensure that the volume serial number and 
owner identification supplied in the command match those found 
on the volume. If they match, execution of the command 
continues; if they do not match, execution of the command 
terminates. | 


The NOPURGE parameter of the INIT command can be specified. 
Exacution of the command terminates if unexpired files; 
data-secured files, or VSAM files are found on the volume. 


The PURGE parameter of the INIT command or the NOPRESERVE 
parameter of the INSPECT command can be specified. If unexpired 
files, data~secured files, or VSAM files are on the volume, data 
loss 15 prevented as follows: 


e Unexpired files: The operator is requested to confirm that 
the contents of the volume can be purged (see message 
ICKO01D in “Appendix C. Device Support Facilities 
Messages"). Only one request is made, regardless of the 
number of unexpired files on the volume. Note that a list of 
the unexpired files is not provided. _ 


e Data-Secured files: If a file is a data-secured file, 
message ICK017D prompts the operator with the name of the 
sacured file, and message ICKO018D requests permission to 
purge the file. This sequence is repeated for each 
data~secured file that exists on the volume. 


@ VSAM files: If a single VSAM file is found on the volume, 
permission is requested for the purging of all the VSAM 
| files on the volume (message ICK019D). 


PROCESSING IN A SHARED ENVIRONMENT (OS/VS) 


The commands INIT, INSPECT, REFORMAT, and BUILDIX require 
exclusive control of the direct access storage volume. Hence, 
the device is reserved by issuance of the RESERVE macro to the 
processor that issued the command. After processing on that 
device is completed, the DEQ macro is issued to release the 
device. 


PROCESSING IN A SHARED ENVIRONMENT (DOS/VSE) 


10 


For all commands, processing continues only after the operator 
has replied to a console message (ICKO020D) granting permission 
to process on the device that 185 being shared. 
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EXECUTING DEVICE SUPPORT FACILITIES 


To use Device Support Facilities, you execute the Device Support 
Facilities command processor. Each command is processed 
completely before processing of another command begins. 


The following sections describe execution of Device Support 
Facilities in several situations: 


e In the stand-alone environment 
° In an OS/VS environment 


® In a DOS/VSE environment 


EXECUTING DEVICE SUPPORT FACILITIES IN A STAND-ALONE ENVIRONMENT 


You execute the Device Support Facilities program in a 
stand-alone environment by loading the program into main 
storaga. The examples in Part 2 of this book illustrate each 
command's use after the program is loaded. 


LOADING THE DEVICE SUPPORT FACILITIES PROGRAM 


For OS/VS Cboth VS1 and MVS), the stand-alone code is found in 
SYSL.SAMPLIB in ICKSADSF. The Device Support Facilities program 
is usually loaded from a file on tape, but can be loaded from a 
binary-card deck. 


The following is sample OS/VS JCL that can be used to copy the 
stand-alone Device Support Facilities code to an unlabelled 
tape. There should only be one file on the tape. Note that 
BLKSIZE=89 is required on the tape data set. 


//JOBNAME JOB JOB CARD PARAMETERS 

//STEPNAME EXEC PGM=ITEBGENER 

//SYSPRINT DD SYSOUT=A 

S/SYSIN DD DUMMY, DCB=BLKSIZE=80 

S/SYSUT1L DD DSNAME=SYS1.SAMPLIBCICKSADSF),UNIT=3330, 


// DISP=SHR,VOLUME=SER=XXXXxXxX, 

//SYSUT2 DD DSNAME=ICKDSF,UNIT=2400-3,LABEL=(,NL), 
// DISP=(,KEEP),VOLUME=SER=YYYYYY, 

// DCB=CRECFM=F,LRECL=80,BLKSIZE=80) 


In the DOS/ZVSE environment, the stand-alone code is found in the 
system source statement library in book Z.DSFSA. You can copy 
the code to a tape by using the DOS/VSE BACKUP utility. The 
following shows sample job control statements to copy the 
stand-alone Device Support Facilities code to a tape. 


// JOB BUILD A STAND-ALONE TAPE 
“7/7 ASSGN SYS006,cuu OUTPUT TAPE FOR STAND-ALONE DSF 
47 MTC REW,SYS006 
// EXEC BACKUP 
SA 
/*® 
/ & 
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Because the procedures for loading a program are not the same 
for all models of processing units, you must load the Device 
Support Facilities program from the tape unit or card reader 
according to the procedures for your processing unit. The 
program contains the instructions necessary to load and store 
itself in the lower addresses of main storage. When the program 
has completely loaded, the processor enters the WAIT state. When, 
the processor enters the WAIT state, the program status word 
C(PSW) should contain the following: 7 
FFO060000 OOFFFFFF 
At this time, you continue by identifying the console, the input 
device, and the output device. | 
Identifying the Console 

You identify the console to the program by pressing the REQUEST 
or ENTER key at the console. You must use one of the following 
consoles: | 

@ 1052 Model 7 Printer-Keyboard 

© 3036 Graphics Console 
=) 3056 Graphics Console 

® 3138, 3148, 3158 Consoles in typewriter keyboard mode 

° 3210 Models 1 and 2 Console Printer-Keyboard 

® 3215 Model 1 Console Printer-Keyboard 

© 3277-2 Graphics Console | 


o 3278-2A Graphics Console 


identifying the Input Device 
After you have identified the console, message ICKO05E prompts 
you to specify the input device and its address. See Appendix C 
for the full message text. You must use one of the following 
input devices: 
¢ 1052 Model 7 Printer-Keyboard 
° 1442 Model N1 Card Read Punch, Model N2 Card Punch 
¢ 2501 Models Bl and B2 Card Reader 
° 2520 Model Bl Card Read Punch, Models B2 and B3 Card Punch 
e 2540 Model 1 Card Read Punch 
* 2560 Multifunction Card Machine 
° 3210 Models 1 and 2 Console Paiacerskeyboand 
e 3215 Model 1 Console Printer-Keyboard 
e 3504 Models Al and A2 Card Reader 
° 3505 Models Bl and Bé Card Reader 
® 3525 Card Punch (with card-read feature) 
° 5424 Card Punch (80 columns only) 


© 5425 Multifunction Card Unit €80 columns only) 
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You can specify the word CARD or one of the device types listed 
above or you can specify the console as the input device by 
entering CONSOLE in response to message ICKOO5E. When the 
console is the input device, you are prompted to enter the next 
line by "ENTER INPUT/COMMAND!®. 


Identifying the Output Device 
After you respond to message ICKO05E, message ICKOO06E prompts 
you to specify the output device and its address. See Appendix C 
for the full message text. You must use one of the following 
output devices: 
. 1052 Model 7 Printer~-Keyboard 
e 1403 Models 2, 7, and Nl Printer 
° 1443 Model Nl Printer 
° 3203 Models 1, 2, 4, and 5 Printer 
° 3210 Models 1 and 2 Console Printer-Keyboard 
° 3211 Model 1 Printer 
° 3215 Model 1 Console Printer-Keyboard 
° 3800 Printing Subsystem 
° 3262 Line Printer 
e 3289 Model 4 Printer 
° 5203 Model 3 Printer 
You can specify the word PRNT or one of the devices listed above 


or you can specify the console as the output device by entering 
CONSOLE in response to message ICKOOGE. 


Specifying the Date and Tima of Day 


The date and time of day are automatically picked up from the 
TOD Ctime of day) clock of the processing unit. Note that the 
TOD clock would typically indicate Greenwich Mean Time, and this 
would be reflected in any listings. : 


In the event that the TOD clock is in error or not set, message 
ICKOL5E prompts you to enter the date. Then, message ICKOIG6E 
prompts you to enter the time of day. In response to these 
messages, you can enter any string of up to 8&8 characters. These 
Will appear in the title line of the output. On the other hand, 
you can press the ENTER key without specifying a date or time of 
day. In this case, the time of day and date are set to zeros. 
Note that these messages can appear again 1f a VTOC entry has to 
bea created for a data sat. It is necessary to furnish the 
information each time it 15 requested if the VTOC entry is to be 
correct. 


ERRGR CONDITIONS 
The stand-alone version of Device Support Facilities requires 
384K bytes of real storage to execute successfully. In the event 
that the real storage available for Device Support Facilities is 
not sufficient, all the input is read and an error condition 15 
posted in the PSW. This error condition is: 

00020000 33222222 

A PSW code of 


00020000 22222222 
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indicates that a unit check occurred on the IPL device during 
the IPL. 


The PSW ‘waieaves the cause of errors that may occur when 
processing Device Support Facilities in a stand-alone 
environment. The processor is placed in a WAIT state and the PSW 
contains the following: 

FFO060000 OOQEEEEnn 
Values of nn indicate the type of error: 


¢ X'43! indicates an SVC interrupt 


*  X'14" jndicates a program interrupt 

e X'15" indicates insufficient main storage 
® X'16' indicates an I/O error 

° X'17" indicates data set not open 


* X'18' indicates console not defined 


® X'19" indicates no end-of-data routine 


PROGRAM TERMINATION 


Execution ee the Device Support Facilities program terminates in 
a stand-alone environment when the end of tha command input 
eercar is encountered. If the console was specified as the input 
device, you enter the characters EOF in response to a request 
for the next command. When the execution terminates, the 
processor is placed in a WAIT state, and the PSW should contain 
the following: | | 


FFOS0000 QQEEEEz2 

where zz indicates the highest decimal condition code 
encountered during execution as shown by the hexadecimal eines 
that appear next. See "Condition Codes to Control Command 
Execution" later in this chapter for an explanation of condition 
codas. | | 

*  X'OO' indicates 0 
® X'04' indicates 4 
° X'08' indicates 8 
° X'OQC"* indicates 12 


® X'10" indicates 16 


Son BA bre Bar Beh 8 he DN? Mve st Se Bete 


In the GS/VS environment you execute Device Support Facilities 
aS a job or ‘iob step. The examples in Part 2 of this book 
illustrate each command's use by obtaining the processor using 
OS/7VS JCL statements. 


You identify the Device Support Facilities processor when you 
state PGM=ICKDSF in the EXEC statement. 
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//SOBNAME JOB YOUR INSTALLATION'S JOB-ACCOUNTING DATA 
//JOBCAT DD DSNAME=YOUR. CATALOG, DISP=SHR 
S/STEPL EXEC PGM=ICKDSF 
S/MYVOL DD UNIT=(devicetype),DISP=O0LD,VOL=SER=VOL123 
//STEPCAT DD DSNAME=ANOTHER. CATALOG, DISP=SHR 
//SYSPRINT DD SYSOUT=A 
S/SYSIN DD x 

Device Support Facilities commands 
/¥* 


JOB CONTROL LANGUAGE EXPLANATION 


PRINTED OUTPUT 


1. //JOBNAME is required. The JQB statement describes your job 
to the OS/VS system. Procedures at your installation may 
require you to supply user identification, accounting, and 
authorization information with the JOB statement's 
parameters. 


2. SZ/JOBCAT is optional. The JOBCAT DD statement identifies a 
user catalog that can be used by each of the job's steps. If 
your job uses only the master catalog, do not specify the 
JOBCAT DD statement since the master catalog 15 always open 
and available to all the jobs on the system. 


3. Z/S5STEPI, an EXEC statement, is required. The EXEC statement 
invokes the Device Support Facilities processor to process 
the Device Support Facilities commands. 


4. Z/STEPCAT is optional. The STEPCAT DD statement identifies a 
usar catalog that can be used when processing the job step. 
If user catalogs are identified with JOBCAT and STEPCAT DD 
statements, only the catalog identified with the STEPCAT DD 
statement and the master catalog are used with the job step. 
If your job step uses only the master catalog, do net 
specify the STEPCAT DD statement, because the master catalog 
is always open and available to all the jobs on the system. 


5. S/SYSPRINT is required. The SYSPRINT DD statement identifies 
the output data set that Device Support Facilities sends 
messages and output information to. (See "Output Data Sets" 
later in this chapter for more information on how ta 
describe an output device other than SYSOUT=A.) 


6. //SYSIN is required. The SYSIN DD statement identifies the 
source of the input statements. An input statement to Device 
Support Facilities 15 a command. When you code SYSIN BD *, 
you identify the statements that follow as input. 


7. The last input statement is followed by 7* in the first two 
columns of the next input record. 
DATA SET 


The normal printed output data set is SYSPRINT. The default 
parameters for this data set are: 


° Record format of VBA 

e Logical-record length of 125 (121 + 4). 

° Block size of 629 (5 x C121 + 4) + 4) 

The first byte is the ANSI control character. The minimum 
specifiable logical-record length CLRECL) is 121 (CU-format 
records only). If a smaller size is specified, it will be 
overridden to lel. 

You can alter the above defaults by specifying the desired 
values in the DCB parameter of the SYSPRINT statement. However, 


the record format cannot be specified as F or FB. If you specify 
either of these, it will be changed to VBA. 
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You 


execute Device Support Facilities as a job. The examples in 


Part 2 of this book illustrate each command's use by obtaining 
the processor with system control statements. You identify 
Device Support Facilities in the EXEC statement by stating EXEC 
ICKDSF. 

“/ JOB jobname YOUR INSTALLATION'S JOB-ACCOUNTING DATA 

“/ ASSGN S$YS010,353 

| f/f EXEC ICKDSF,SIZE=AUTO 
Device Support Facilities commands 
7 
£& 


SYSTEM CONTROL STAT 
i 


PRINTED CUTPUT 
All 


EMENTS EXPLANATION 


// JOB is an optional statement used to describe your job to 
the DOS/VSE system. 


// ASSGN causes the SYSNAME SYS010 to be assigned to the 
device whose channel and unit address is 353. 


/*% appears in the first two columns of the input record 
following the last input statement. 


7/& appears in the first two columns of the input record. 
following the /* card to indicate end of job. 


printed output is directed to SYSLST. 


CONTROLLING COMMAND EXECUTION 


Comm 
foll 


CONDITION CODES TO 
The 


and execution can be controlled by the statements that 
OW > 


The IF-THEN-ELSE statement sequence tests a condition coda 
and controls execution of subsequent commands according to 
the results of the test. The IF statement is followed by 
THEN and ELSE clauses, which specify alternative actions. DO 
and END statements are optionally part of THEN and ELSE 
clauses and specify the beginning and ending of a statement 
saquence when you want to specify more than one Device 
Support Facilities command with either a THEN or an ELSE 
clause. 


The SET statement sets condition codes. 


CONTROL COMMAND EXECUTION 
condition codes compared in the IF-THEN-ELSE statement 


sequence are LASTCC and MAXCC, which take the following values: 


0 


16 Device Support 


Indicates that the command was executed as specified. Some 
informational messages may have been issued. 


indicates that some problem was met while executing the 
complete command, but Device Support Facilities processing 
continued. The continuation might not provide the user with 
exactly what was wanted, but no data or volume has been 
permanently harmed. A warning message was issued. An 
example of the kind of problem encountered is: the system 
ignored a parameter that was specified but did not apply. 
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indicates that a requested command was completed, but some 
actions were unavoidably bypassed. For example, Device 
Support Facilities was unable to reclaim an alternate 
track. 


le 
indicates that the requested command could not be executed. 
This condition code is a result of a logical error or a 
problem during execution. A logical error exists, for 
example, when inconsistent parameters are specified, when a 
too-small or too-large value is specified, or when required 
parameters are missing. A problem during execution exists 
when the volume label cannot be changed. 


16 
indicates a severe error occurred, causing the remainder of 
the command stream to be flushed. For example, this 
condition code might be a result of the following: the 
system output data set could not be opened (the SYSPRINT DD 
statement was missing, perhaps); an unrecoverable error 
occurred in a system data set; or Device Support Facilities 
encountered improper IF-THEN-ELSE statement sequences. 


LF-THEN-ELSE STATEMENT SEQUENCE 


You use the IF-THEN-ELSE statement sequence to control command 
execution. The syntax of the IF-THEN-ELSE statement sequence 1s: 


{LASTCC comparison operator 
condition code 
MAXCC comparison operator 
condition code} 


THEN Ecommand | 
DO 


command 
END] 


[ELSE: £ command | 
DO 


command 
END] j 


where: 


IF specifies that one or more Device Support Facilities commands 
are to be executed based on a test of a condition code value. 
The condition code was set by a SET command or reflects the . 
completion status of previous Device Support Facilities 
commands. | 


LASTCC comparison operator condition code specifies that the 
condition code value resulting from the immediately previous 
Device Support Facilities command is to be compared to the 
condition code indicated by the comparison operator to determine 
whether the THEN or ELSE action is to be performed. See 
"Condition Codes to Control Command Execution" earlier in this 
chapter for the explanation of condition codes. | 


For comparison operator, substitute one of the following six 
comparison operators to compare the condition code resulting 
from the previous Device Support Facilities command and the 
condition code you specified tin the IF statement: 

® Equal, specified as = or EQ 


e Not equal, specified as -= or NE 
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® Greater than, spaci fied as > or GT 


® Less than, specified as < or LT 
6 Greater than or equal, specified as >= or GE 
e Less than or equal, specified as <= or LE 


For condition code, substitute the decimal number, up to ten 
digits long, that is to be compared with LASTCC. Condition codes 
greater than 16 are reduced to 16. See "Condition Codes to 
Control Command Execution™ earlier in this chapter for the 
explanation ef condition codes. 


MAXCC comparison operator condition coda specifies that the 
maximum condition code value resulting from any previous Device 
Support Facilities command or a SET command is to be compared to 
the condition code indicated by the comparison operator to | 
determine whether the THEN or ELSE action is to be performed. 
See "Condition Codes to Control Command Execution" earlier in 
this chapter for the explanation of condition codes. 


For comparison operator, substitute one of the following six 
comparison operators to compare the maximum condition code 
resulting from any Device Support Facilities command and the 
condition code you specified in the IF statement: 


° Equal, specified as = or EQ 

° Not equal, specified as ~= or NE 

* Greater than, specified as > or GT 

e Less than, specified as < or LT 

® Greater than or equal, specified as >= or GE 
° Less than or equal, specified as <= or LE 


For condition code, substitute the decimal number, up to ten 
digits long, that is to be compared with MAXCC. Condition codes 
greater than 16 are reduced to 16. Sea "Condition Codes to 
Control Command Execution" earlier in this chapter for the 
explanation of condition codes. 


THEN specifies that a single command (or a group of commands 
introduced by DO) is to be executed if the comparison is true. 
THEN can be followed by another IF statement. 


ELSE specifies that a single command Cor a group of commands 
introduced by DO) is to ba executed if the comparison is false. 
ELSE can be followed by another IF statement. 


When an IF statement appears in a THEN or ELSE clause, it 15 
called a nested [IF statement. The maximum number of nested 
levels allowed is 10, starting with the first time you specify 
LP, | 


Within nested IF statements, the innermost ELSE clause is 
matched to the innermost THEN clause, the next innermost ELSE 
clause 1s matched to the next innermost THEN clause, and so on. 
In other words, each ELSE clause 1s matched to the nearest 
preceding unmatched THEN clause. If there is an IF statement 
that does not require an ELSE clause, follow the THEN clause 
With a null ELSE clause, unless the ‘nested structure does not 
require one. 


DO command can be specified with the THEN and ELSE clauses to 
indicate that the group of commands following are to be treated 
as a single unit, that is, to be executed as a result of a 
single IF statement. Commands following a DO must begin on a new 
line. The group of commands is terminated by END. 
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For command, substitute the Device Support Facilities command 
that you want to process as a result of a single IF statement. 


END specifies the end of a group of Device Support Facilities 
commands initiated by the nearest unended DO. END must be on a 
line by itself. 


NULL THEN AND ELSE CLAUSES 


SET STATEMENT 


When a THEN or ELSE clause is not followed by a continuation 
character or by a command in the same record, it results in no 
action. 


For example, to specify a null THEN clause when you want a 
Device Support Facilities command to execute if the IF statement 
is false, you specify THEN without a continuation character or 
Device Support Facilities command. On the next line, specify 
ELSE followed by a Device Support Facilities command. If you 
want to specify a null THEN clause, specify: 


1S ae 
THEN 
ELGG 


If you want to indicate a null ELSE clause, specify: 


St oe 
THEN 
ECOG 


The SET statement sets a condition code. See "Condition Codes to 
Control Command Execution" earlier in this chapter for the 
explanation of condition codes. You can terminate all processing 
simply by setting MAXCC or LASTCC to 16. 


The syntax of the SET statement is: 


SET {LASTCC = condition code] 
MAXCC = condition code} 


wnere: 


SET specifies that a condition-code value is to be set. If a SET 
statement is specified following a THEN or ELSE clause, and the 
clause 15 not executed because the comparison in the IF 
statement does not allow the clause to execute, the condition 
code specified with LASTCC or MAXCC is not set. 


LASTCC = condition code specifies that the condition code to be 
set is the condition code set by the immediately previous Device 
Support Facilities command. 


For condition code, substitute a decimal number, up to ten 
digits long, that is to be assigned to LASTCC. Condition codes 
greater than 16 will be reduced to 16. If the condition code 
assigned to LASTCC is a greater value than the condition code 
assigned to MAXCC, MAXCC assumes the condition code assigned to 
LASTCC. : | | 


MAXCC = condition code specifies that the condition code to be 
set is the maximum condition code. Setting MAXCC does not affect 
the condition code for LASTCC. 


For condition code, substitute a decimal number, up to ten 


digits long, that 15 to be assigned to MAXCC. Condition codes 
greater than 16 will be reduced to 16. 
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Continuation Lines 


Use continuation lines cautiously when specifying IF-THEN-ELSE 
statements, SET statements, comments, or blank records in the 
input stream. Blank records or records ending with comments must 
end with a continuation mark when you specify these types of 
records in the middle of a command or between the THEN and ELSE 
clauses of an IF statement. Always specify a continuation mark 
when records end with partial comments. (See "Line 
Continuations"™ on page 23 and "Comments™ in Part 2.) 


You must be careful when you continue IF-THEN-ELSE statements so 
that you don't inadvertently specify a null THEN or ELSE clause. 
For information on this subject, see "Null THEN and ELSE 
Clauses" earlier in this chapter. 
EXAMPLES OF STATEMENTS TO CONTROL COMMAND EXECUTION 
‘The examples that follow show the use of the IF-THEN-ELSE 
statement sequence and the SET statement. 
IF-THEN-ELSE Statement: Example 1 
INIT DDNAMECVOLXYZ) VERIFYCVOLABC) 
IF LASTCC=0- 
THEN REFORMAT DDNAMECVOL293) VOLIDCSYX1) NOVERIFY 
ELSE REFORMAT DDNAMECVOL123) VOLIDCSYX2) NOVERIFY 
SET Statement: Example 2 


SET LASTCC=8 
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PART 2. REFERENCE INFORNATIGN 


This part of the book is to be used as a reference when you code 
the Device Support Facilities commands. Tha commands are 
arranged in alphabetic order. The presentation of each command 
includes: 


@ A general description of the command and its use 

e A table summarizing the syntax of the command 

° An explanation of required and optional parameters 
° Examples 
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SYNTAX OF THE DEVICE SUPPORT FACILITIES COMMANDS 


The illustrations of command formats in this book use the 
following conventions: © | 


e Brackets ([]) indicate an optional field or parameter. 


e Braces ({}) indicate that one of alternative items must be 
selected. | 


e Items separated by a vertical bar (]) represent alternative 
items. Only one item may be selected. 


@ An ellipsis (€Ceee) jndicates that multiple entries of the 
type immediately preceding the ellipsis are allowed. 


® Boldface type indicates the exact characters to be entered. 
Such. items must be entered as shown or in the abbreviated 
form allowed. 


° Underscored uppercase type indicates a default option. If 
the parameter is omitted, the default value is assumed. 


® Underscored lowercase or lowercase type indicates fields to 
bea supplied by you. 


® Parentheses, commas, slashes,» spaces, and other punctuation 
must be entered as shown. 


@ Numeric parameters can be coded in two ways: decimal or 
hexadecimal CX'n'). This applies to any parameter that 
specifies a substitution of decimal numbers. 


® Character string parameters can be coded either with or 
without enclosing them in single quotation marks. However, 
if delimiters such as commas, blanks, or parentheses appear 
Within a character string, the string must be enclosed 
within single quotation marks. 


You can specify values with some keyword parameters. The value 
is entered within parentheses following the keyword parameter. A 
typical keyword with a value appears in this book as: 


VOLIDCserial) 


A value cannot contain commas, semicolons, blanks, parentheses, 
or slashes unless the entire value is enclosed within single 
quotation marks. CA single quotation mark ina field enclosed 
Within quotation marks must be coded as two single quotation 
marks.) 


Positional Paramaters: In the explanations of commands within 
this book, the positional parameters are shown in lowercase 
underscored letters or lowercase letters. When a positional 
parameter consists of a list of items, you must enclose the list 
in parentheses. 


ABBREVIATING COMMANDS AND PARAMETERS 


Some of the commands and parameters can be abbreviated. 
Abbreviations for commands are listed just before the syntax of 
the command is shown. Abbreviations for parameters are shown 
With the heading "Abbreviations." The full form of the parameter 
is given first, then acceptable abbreviations. A vertical bar 15 
used to separate the parameter and its abbreviations. 
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DELIMITERS 


When you issue a command, you must separate the command name 
from the first parameter by one or more blanks. You must 
separate parameters from each other by one or more blanks or a 
comma. Do not use a semicolon as a delimiter because any 
characters that follow a semicolon are ignored. 


LINE CONTINUATIONS 


A command, IF statement, or comment can be entered using one or 
more lines. To continue a command or comment that requires more 
than one line, each line, except the last, must be terminated by 
a plus or minus sign in the last nonblank column at or before 
column 72. The minus sign causes leading blanks in the following 
line to be read as part of the command. The plus sign causes 
leading blanks in the following line to be tgnored. 


COMMENTS 
You can add comments to any of the commands wherever a blank 
character can appear. To distinguish your comments from the 
commands, enter them within the comment delimiters /*% and */7. A 
comment may be continued to the next line by using a line 
continuation character at the end of the line. 

TERMINATOR 


The terminator indicates the end of the command. The terminator 
can be either an end-of-command condition Cthat 15, no 
continuation mark) or a semicolon. If you use the semicolon as 
the terminator, the semicolon cannot be enclosed in quotation 
marks or embedded in a comment. Everything to the right of the 
semicolon is ignored. If there is information to the right of 
the semicolon that 15 continued to another record, all the 
information including the continued information is ignored. 


For example, if you code: 


REFORMAT UNITADDRESS(C353) VOLIDCAA2314); VFYCBB2314,SMITH) - 
1, a eee 
REFORMAT 


characters following the semicolon terminator are ignored. The 
continuation mark Cminus sign) at the end of the second record 
causes the INIT command to be ignored also. The two REFORMAT 
commands are the only commands that are recognized. 


USING THE DEVICE SUPPORT FACILITIES CONMANDS 


A command consists of a command name followed by one or more 
operands or parameters. Hereafter, all operands described in 
this book are called parameters. They provide the specific 
information required for the command to perform the requested 
function. 


For example, some parameters associated with the INSPECT command 
indicate where the volume is mounted, the tracks that are to be 
inspected, and the verification of volume serial number and 
owner identification. 

The following 1s an example of this command: 


INSPECT DDNAMECVOL1) TRACKS((€4,6),04,10)) VERIFYCDSF123,SMITH) 
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where: 


® DDNAME specifies the DD statement that contains the 
description of the device. 


® TRACKS specifies that cylinder 4%, tracks 6 and 10 are to be 
inspected. | 


® VERIFY specifies that volume serial number DSF123 and owner 
identification SMITH are to be verified before inspection 
continues. 


Several of the parameters take default values if they are not 
specified when the command is issued. In the foregoing example, 
the following parameters were not specified, but are defaulted: 


® CHECKC1) indicates that track surfaces are checked for 
recording errors. 


® NORECLAIM indicates that no attempt is made to reclaim 
tracks that were previously flagged defective. 


e PRESERVE indicates that existing data on the inspected 
tracks is saved and rewritten. 


° MAP indicates that a volume map is printed after the command 
processes. 


® ASSIGN indicates that alternate tracks are assigned for the 
spacified tracks if they are shown to be defective as a 
result of surface checking. 


Note: When using an 80-column card format, the Device Support 
Facilities commands must be entered within columns 2 and 72. 

the length of the command exceeds column 72, a continuation mark 
must be entered, and the command continued on the next line. 
When commands are entered at the console in a stand-alone 
environment, they can begin at the left margin and are also 
subject to the 72-column maximum. If conflicting keyword 
parameters are entered, execution of the command terminates. 


Conflicting keyword parameters are identified by a logical OR 
sign (|) representing alternative items. 
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ANALYZE 


ANALYZE: ANALYZING A VOLUME 


The ANALYZE command is for use with IBM direct~-access storage 
devices (DASD) that have nonremovable storage media. ANALYZE 
examines the drive and the user's data to determine if there are 
errors. When ANALYZE detects an error, it prints a message to 
the ae and prints diagnostic tnformation on the system's 
printer. 


ANALYZE only supports those devices which have nonremovable 
storage media. ANALYZE provides the user with the tool needed to 
determine whether the error is caused by the pack (that is, the 
storage medium) or by the drive; and whether to start data 
recovery procedures, or to call a customer engineer or service 
representative. ANALYZE also provides output that assists in 
locating and fixing the problem. 


USING ANALYZE OUTPUT 


As part of an installation's operating procedures, ANALYZE 
output can assist in determining whether or not recovery 
procedures can or should be executed. However, the use of 
ANALYZE output by customer engineers or service representatives 
to isolate and to repair drive malfunctions should not replace 
the use of more detailed diagnostic tools and procedures 
available for that purpose. ANALYZE output in such instances 
should serve only as the initial reference material that shows 
the final problem symptom but does not specifically isolate the 
problem source. 


ANALYZE can determine whether the device to be tested is a 
nonremovable storage medium device or not. If the device to be 
tested is a 3350, ANALYZE also determines whether the logical 
volume is in native mode or one of the compatibility modes. If 
an attempt is made to execute ANALYZE against a device other 
than one with nonremovable storage media, ANALYZE issues an 
error message to the operator and processing terminates. 


Two basic tests are performed by ANALYZE—the drive test and the 
data verification test. The drive test is a general exercising 
of the storage device by issuing SEEK, READ, and WRITE commands. 
From the results of issuing these commands, ANALYZE determines 
the drive's ability to perform expected actions. 


Note: WRITE commands are only issued when the read/write head is 
positioned in the CE cylinder. If the drive test is completed 
successfully, the data verification test, which 15 optional, can 
then be performed. The data verification test reads Cwithout 
data transfer across the channel to the CPU) to the maximum of 
every user data record on the logical volume. This determines 
whether the data can be read correctly——that is, without 
uncorrectable data check errors. CA logical volume is a portion 
of a physical volume that is viewed by the system as a volume.) 


In addition, a data verification option is provided that allows 
you to specify a portion of the volume for testing. For the 
supported count key data devices, one or more cylinders can be 
specified. For the supported fixed block devices, one or more 
blocks can be specified. You may also perform data verification 
for the entire volume. 


ANALYZE does not require exclusive control of the drive under 
test. Most of ANALYZE's CCW chains (that is, its channel 
programs) do not hold the drive busy for longer than 0.5 second. 
However, if the operating system executes its error recovery 
procedures as a result of I/0 errors detected during ANALYZE 
processing, the error recovery procedures may hold the drive 
busy for a longer period of time. 
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ANALYZE 


Assumptions 


ANALYZE data verification testing allows you to control the 
duration of each EXCP by specifying either SPEED or NOSPEED. 
This controls the duration of each EXCP as follows: 


e For the supported count key data devices, one EXCP per track 
15 1ssued when NOSPEED is specified. When SPEED 1s 
specified, there 1s one EXCP issued for each cylinder. 


e For the supported fixed block devices, if NOSPEED is 
specified, one EXCP is issued (to read 32 and 248 blocks 
respectively). When SPEED is specified, one EXCP is issued 
to read 352 and 748 blocks respectively. 


ANALYZE supports the 3310 and 3370 devices in fixed block mode 
only. This mode is based on data transfers of 51l2-byte 
increments (Cllocks) for storing and retrieving data. 


When you run ANALYZE, the following conditions are assumed to 


exist 


e The home address on each track in the user area is correct 
and readable. 


e The part of the CE cylinder that is written on by ANALYZE is: 
free from defects. Also, the home address on each track in 
the CE cylinder is correct and readable. 


° All records on the logical volume's track in the user area 
~ have been written in a format consistent with the IBM 
standard record format. 


e The 3310 and 3370 data fields have been previously 
initialized Call data fields written). 


WHAT ANALYZE TESTS 


The Drive Test 


When an error occurs, the device Cand its storage control unit) 
usually corrects the error and doesn't notify the operator or 
programmer that an error occurred. Under OS/VS, such errors are 
recorded by the operating system's error-recovery procedures 
CERP). Data about those errors is available in the system's 
error log and printout, which is usually examined by the 
installation'’s system programmer and by the customer engineer or 
service representative who serves the installation. Under 
DOS/VSE, system error-recovery procedures are bypassed, and 
ANALYZE does its own sense analysis. Senses are printed by 
Device Support Facilities on SYSLST. 


Errors that are more persistent and that cannot be corrected by 
the device's internal error-correction circuitry result in 
messages to the operator on the system console and on the output 
printer. Also, data errors may occur that cause a user to 
suspect a drive failure rather than a programming error. The 
three types of drive failures are drive errors, media errors 
(problems with the disk surface), and data format errors Cthe 
data is written in a format not consistent with the IBM standard 
format). ANALYZE performs two testing procedures to detect 
errors-~~the drive test and the data verification test. 


ANALYZE first determines the drive is fully operational by 
performing I/0 operations that test the drive's functional 
capabilities. Each I/O operation, called a channel command word 
(CCW) chain, tests a specific function of the drive and logical 
volume. Tests are executed in order of increasing complexity. 
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ANALYZE 


Drive problems that can be detected during ANALYZE's initial 
tasts are access arm positioning errors and the ability to read 
and write (Cin the CE cylinder). For the 3344 and 3350, the drive 
is also checked to ensure that it can detect an address mark, 
can switch read/write heads as a result of a multitrack command, 
can sense the disk's rotational position, and can detect and 
skip over defective areas ona track. 


The Data Verification Test 


If ANALYZE completes all drive tests without error, the data 
verification test can be run. The ANALYZE data verification test 
determines the status of the drive's storage medium by reading 
(without data transfer to the processor) to the maximum of all 
data records on the volume. If a data check 185 detected during 
the test, both the address and the cylinder and head number or 
relative block number are noted ina diagnostic message on the 
printer. When a track or block is found to be defective, you can 


bypass the defect by assigning an alternate track or block to 
replace it. 


ANALYZE allows you options for the data verification tests: 
e You may specify data verification of the whole volume. 


e You may select a range of data to be verified either by 
cylinders or by blocks. 


e You may also select the SPEED or NOSPEED parameter or the 
data verification tests. 


SPEED specifies: 


= Perform one EXCP per cylinder for the count key data 
devices. 


cs Perform one EXCP for the maximum number of blocks (352 
and 744 respectively) within the range specified for the 
3310 and 3370. 


NOSPEED specifies: 


z Perform one EXCP per track for the count key data 
devices. 


= For the 3310 and 3370 the number of blocks read by each 
EXCP is 32 and 248 respectively. 


Note: When errors other than data check occur during the data 
verification test, the errors may be identified by ANALYZE as 
data check errors. When you examine the sense information, 
however, you can determine whether the error is actually a data 
check or an intermittent or marginal drive error. 
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ANALYZE 


SYNTAX 


| Required Parameters 


ANALYZE | UNITADDRESS(Ccuu) | 
DDNAMECcdname) | 
S YSNAME Csysxxx) 


| Optional Parameters 


SCAN|NOSCAN 

LIMITS €scanlo,scanhi)|ALL 
SPEED|NOSPEED 

MSS 


UNITADDRESS [DDNANE|SYSNANE? IDENTIFYING THE DEVICE ON WHICH THE VOLUME IS 
MOUNT | 


are 

jen 

ew 
orenieaee 


mi 


Explanation: UNITADDRESS(cuu)]DDNAME(dname) ISYSNAME(sysxxx) are 
required parameters identifying the volume that is to be 
analyzed. 


UNZITADDRESS 
Required when analyzing a volume that is mounted offline or 
when analyzing a volume in a stand-alone environment. 


For cuu, specify the address in hexadecimal of the channel 
and unit on which the volume is mounted. 


Note: The device must be on a channel that is online. If 
the device 18 on a channel that is offline, the program may 
enter a nonterminating wait state. 


DDNANE 7 
Required when analyzing a volume that is mounted online. 
The device on which the volume is mounted must be online. 


For dname, specify the OS/VS JCL statement that identifies 
the device on which the volume 15 mounted. | 


SYSNAME | 
Required when analyzing a volume in the DOS/VSE 
environment. For sysxxx, specify the SYSNAME in the ASSGN 
system control statement. 


Abbreviations: 


UNITADDRESS|UNITADDR| UNIT 
DDNAME | DNAME 


Defaults: None 


Restrictions: The DDNAME or SYSNAME parameter cannot be 
specified when analyzing a volume in a stand-alone environment. 


Explanation: SCAN|INGSCAN are optional parameters specifying 
whether the data verification tests are to be run after 
successful completion of the drive tests. 


SCAN 
Indicates that you want the data verification tests to be 
run after successful completion of the drive tests. 


28 Device Support Facilities User's Guide and Reference 


ANALYZE 


NOSCAN 
Indicates that you do not want the data verification tests 
to be run after successful completion of the drive tests. 


Abbreviations: 


SCANISCN 
NOSCAN|NOSCNINSCANI|NSCN 


Default: NOSCAN 


Restrictions: None. 


LIMITS: SPECTFYING THE AREA OF DATA VERIFICATION 


Explanation: LIMITS(€scanlo,scanhi)|ALL are optional parameters 
to specify the area of the disk where data verification is to be 
performed. For fixed block devices, you specify the range of 
blocks to be read during the data verification tests. For count 
key data devices, you specify the range of cylinders that are to 
be read during the data verification tests. 


LINZTS€scanlo, scanhi ) 
scanlo specifies, for fixed block devices, the relative 
block number for the start of the data verification tests. 
For count key data devices, scanlo specifies the relative 
cylinder number for the start of the data verification 
tests. scanlo can be expressed in decimal (Cn) or 
hexadecimal (X'n') form. 


scanhi specifies, for fixed block devices, the relative 
block number of the last block of the data verification 
tests. For count key data devices, scanhi specifies the 
relative cylinder number of the last cylinder of the data 
verification tests. scanhi can be expressed in decimal (Cn) 
or hexadecimal (X'n'") form. 


Note: For fixed block devices, a rounding algorithm is used 
to calculate, depending on whether the SPEED or NOSPEED 
option is chosen, the optimum number of blocks to be read 
for each EXCP. (This optimum number of blocks takes 
advantage of certain device characteristics to aid in 
further isolation of problems.) For example, if you code 
SCAN LIMITS(CO,10) on the control statement and the device 
is a 3310, the channel program would be built to read 32 
blocks starting at relative block 0; and if SPEED were 
coded, the channel program would be built to read 352 
blocks. 


Also, the numbers scanlo and scanhi must be equal or in 
ascending order, and they must fall within the device 
address limits: low to high relative cylinder number or low 
to high relative block number. Incorrect specification will 
result in an error message and cause execution of the 
command to terminate. 


ALL 
An aptional parameter which specifies that all blocks or 
all cylinders are to be read during the data verification 
tests. 

Abbreviations: 


LIMITS|LIMIT|LIMS|LIM 
Default: ALL 


Restrictions: The LIMITS parameter applies only when the SCAN 
parameter has been specified. 
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ANALYZE 


SPEED |NOSPEED: 


_SPECIFY DATA VERIFICATION TESTS 


Explanation: SPEED|NOSPEED are optional parameters which specify 
how much is read by each EXCP for the data verification tests. 


SPEED 


For the 3310 and 3370, this parameter specifies that the 
maximum number of blocks is read for each EXCP (352 and 744 
respectively). For count key data devices, one cylinder is 
read at a time. 


NOSPEED | 
For the 3310 and 3370, NOSPEED specifies the number of 
blocks for each EXCP is 32 and 248 respectively. For count 
key data devices, one track is read at a time. 


Abbreviations: 
NOSPEED|NSPEED. 
Defaults: NOSPEED. 
Restrictions: You should not specify SPEED when you are running 


under VM/370, as this degrades the performance of other VI1/370 
users. | | 


MSS: ANALYZING AN MSS STAGING VOLUME 


Explanation: MSS is an optional parameter to be specified only 
when ANALYZE is executed against an emulated $350- 11 MSS staging 
volume that resides on a 3350 device. 


By specifying this parameter, you are allowed to specify 
cylinder 808 Cinstead of cylinder 807) as the upper limit for 
the data scan portion of the command (see the LIMITS parameter). 


Abbreviations: None. 
Defaults: None. 


Restrictions: If the MSS parameter is specified without the 
LIMITS parameter, the data scan, if requested, will include 
cylinder 808. If MSS is not specified, ANALYZE will treat the 
volume as a nonstaging volume and will allow only cylinder 807 
as the data scan upper limit. 


EXAMPLES OF THE ANALYZE COMMAND 


The following examples show different ways to use the ANALYZE 
command 


Note: Any values specified here are examples only and should not 
be interpreted as the values for your system. 


ANALYZING A VOLUME IN A STAND-ALONE ENVIRGNMENT: EXAMPLE 1 


In this example, the 3310 Direct Access Storage drive tests are 
performed. | 


ANALYZE UNZTADDRESS(141) | 
Using keyword abbreviations, you could have specified: 


ANALYZE UNITC141) 
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ANALYZING A VOLUME IN A STAND-ALONE ENVIRONMENT: EXAMPLE 2 


In this example, the 3310 Direct Access Storage drive tests are 
performed and are followed by the data verification tests for 
the entire 3310 volume. ALL is the default. 


ANALYZE UNITADDRESSC141) SCAN 


ANALYZING A VOLUNE IN A STAND-ALONE ENVIRONMENT: EXAMPLE 3 


In this example, the 3370 Direct Access Storage drive tests are 
performed, followed by partial data verification tests 
beginning at relative block number 25 and ending at relative 
block number 50. Abbreviations have been used. 


ANALYZE UNITC141) LIMSCX'19',X"'32') SCN 


Note: For this fixed block architecture device, the actual data 
verification would have resulted in two EXCPs being issued. The 
first would have read relative blocks 0 through 31; the second 
would have read relative blocks 32 through 63. The rounding 
algorithm, taking the default of NOSPEED, first verified that 
tne limits were within the device limits, and then rounded up 
the high Limit to 65 and then rounded down the low Limit to 0, 
resulting in two EXCPs, each reading 32 blocks. CIF SPEED had 
been specified, rounding would have resulted in one EXCP to read 
352 blocks.) 


ANALYZING A VOLUME IN A STAND-ALONE ENVIRONMENT: EXAMPLE & 


In this example, the 3350 Direct Access Storage drive tests are 
performed, followed by partial data verification tests beginning 
at relative cylinder 6 and ending at relative cylinder 9. 


ANALYZE UNITADDRESS(351) LIMITS(6,9) SCAN 


ANALYZING A VOLUME IN AN OS/VS ENVIRONMENT CONLINE): EXAMPLE 5 


In this example, drive tests are performed on two volumes 
(designated as VOLUMEG and VOLUME2). Specification of the SCAN 
parameter indicates that data verification tests are to be run 
after successful completion of the drive tests. 


/7EXAMPLE5 JOB 
Cf EXEC PGM=ICKDSF 
7/NOLUMEG DD UNIT=3330,DISP=OLD,VOL=SER=PAY345 
//NOLUME2 DD UNIT=3330,DISP=OLD,VOL=SER=PAY320 
//SYSPRINT DD SYSOUT=A 
/7SYSIN DD bs 

ANALYZE DDNAMECVOLUMEG) 

ANALYZE DDNAMECVOLUME2) SCAN - 

LIMITS(2,5) 

/* 


ANALYZING A VOLUME IN A DOS/VSE ENVIRONMENT: EXAMPLE 6 


In this example, drive tests are performed on the volume SYSO001. 
Specification of the NOSCAN parameter indicates that data 
verification tests are not to be performed. 


// SOB jobname 
// ASSGN SYS001,150 
| 4/7 EXEC ICKDSF,SIZE=AUTO 
ANALYZE SYSNAMECSYS001) NOSCAN 
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ANALYZING AN MSS VOLUME IN AN GS/VS ENVIRONMENT (OFFLINE): EXAMPLE 7 


| 
In this example, drive tests are performed on ah MSS volume 
(3330-11 emulated on a 3350) that is mounted on a cuu address of 
164. | 


7/Example7 JOB | 
17 EXEC PGM=ICKDSF 
“/SYSPRINT DD SYSOUT=A 
//SYSIN DD x 

ANALYZE UNITC164) MSS 
1% 


DIAGNOSTIC MESSAGES 


(orakesnmnvinmarnnalntntar srs remem matin 


ANALYZE prints diagnostic messages on the system printer or on 
the system console. They can be used by a programmer Cand by the 
customer engineer or service representative) to determine more 
precisely the kind of problem that .is detected by ANALYZE. 


A diagnostic message names the test in which the failure 
occurred, and is followed by information appropriate to | 
dascribing the error-—a display of the failing CCW, the CSW at 
the time of failure, and the sense bytes, as follews: 


SNS TEST | 

CSW = 008050 OE000000 CCW = O041F8D78 20000018 

SENSE = 10000800 10008910 180B60B5 400E138F OEF010003 
00001440 . | a 


In the above example, a channel command word (CCW) issued during 
the SNS test failed. In the CSW, the channel end, device end; 
and unit check indicators are on. For more details on CCW, CSW, 
and sense byte interpretation, see the appropriate direct-access 
storage reference manual (see the Jist in the "Preface"™). 


Diagnostic messages are issued during the drive tests and data 

verification tests if an error is detected. These messages and 

their meanings are shown in Figure 3 on page 33 and Figure 4 on 
page 34. 


Most of the diagnostic messages are useful only to the customer 
engineer or to the service representative. Four of the 
diagnostic messages, however, are useful to the programmer who 
analyzes the output from ANALYZE. The four messages are 
described below so that you can understand the conditions under 
which each is issued. Your installation's recovery procedures 
may correct the problems indicated by these messages, so that 
you do not have to call a customer engineer or service 
representative to correct them. 


e WRT WRITE INHIBIT SWITCH ON 


This condition is detected when the WRT test attempts to 
write a record and fails because the "R/W or READ" switch on 
the drive's operator panel is in the "READ" position. 


This message provides sense information that verifies 
console message ICK414I1. The operator's response to message 
ICK414I usually corrects the condition. The operator should 
rerun ANALYZE if the testing of the drive's writing 
capabilities is desired. 
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MOVABLE HEAD ERROR TABLE. 
HEAD NUMBER DATA CHK SEEK VERIFY WRITE CHK DATA CHK DATA COMP 
CHECK CE CYL ERROR 


 <e Com wee GE WeUh come bane enn ee ve ce ED wee we pe Gem GOED ee fee ome ee ew eee ee ee ee Se ee ee Ee — oe eee ee cE ene ane eee om ee 


— ee ee ee ee wee Gees we Ge wee ee ee ae ew Un CE Gan HD een em Ge me wee cue ee te er eee ee ome enh 


we ee em ae te ee we em ee ome we Se au aa CER Ge ee em SES a em — a wow wen GE Ce Gum GEie Gm ee Cm —_ em wer eee eee am ee em oT we 


a ee ee ee Ee ED eee CY Rm coe or eee oe ee ee Ee ee ee ee ee ee ee eRe [ee eve CR ome CES GE ee GD wD wan wD —_ “ae we ew Ge eS ee ee Ne we 


am Crem ete cae GER EN ume WED UteO eee aa RD CS OR eee WED wee ene uN WED Gm Gee tee > Gr em ee were eee ene ED eens See teee we tN GD em ee Om Guns eon Gm cee 


ee ne Cm ve We Gee Ee OD ey eee wee we ee Gee ane Gem au nem ous Cy WE te eu 9 a ne Oe Ee ee Gee Ge a oD ay Ge aD ca AD tee wee eee wo ee 


ee OD EE GE Se CES GE wh enee ues ewe ee eee ee Se ER wee we UY mene elm Cow <p ws wen ene Em eee me Gee een wey vee om carn ene eee en teen Ge cee CD mee 


| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

| | | 

eceroanss (Gasca en aces [eteetetatateerarane! lenatettetetererens 

14 ----- | ---------- | ------------- | -----------|---------- 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 


ms ee ee ey te eORe cue te eet geen emt ee Gl wReT eee Geen URED men ens ND we fete ene me wee ety ean eRe wee om OP ee wes See me eure we Gu eee GE um ae Gob wee 


ee ee ee ee ee ee ee ee em ere — cus GUE Une GENS wen GES Gem mane GED Ea coms tet —— ee ae ae ee ee a be ome ee on a ae Bete EP ie Ce ee Oe ee we 


om ee eee wee: ee we me ee ee Bene oe ee Se ee wee eee ee Seo GE Ee ee eee ee ere TEND CRA Guee ques va qm Wane Geen Gnd wee —— a ee ao mee Cem ee eee ee eee 


_—. ep ee ee Oe ee ee ne Ee cee we ween me ee wee eee ee eee ee ee ee ee ee a Wt cee web CD gee wen Gem «ene ep conn —_ oes EP em sew em as cme SeE Une 


ome cane em ce te ce ee Te Eee oe ‘om qa Wend aes eupe mum wm wun fey CED Ge oem Go me See ee cee em awe we Gee ce eo Eee os TE wee i wn coe Ged om om 


ITED See ERO LIONEL SERENE ES TE LS AA ES GAS NT AOS OS SOE ES EE TS EE CNS TE TS AS SNE OS 
CRTC ONL CAEL CAEL ENED LOREEN ID TOD AIS SCE EE TD ORE EID OE CE ES AS NE TE TS NS NS TD ONSET ere TO 
ao 


Figure 3. The Movable Head Error Table 


® DATAVER DATA CHECKS EXCEEDED THRESHOLD 


A data check is a read/write error that the device detects, 
and is indicated in the sense bytes. When the number of 
tracks with data checks for a logical volume exceeds the 
number of alternate tracks for the volume, the data 
verification test prints this message and terminates. The 
threshold for each type of logical volume is: 


IBM 3344 logical volume-—-24 data checks 

IBM 3350 Cnative mode) volume-—150 data checks 

IBM 3350 €3330-1 mode) logical volume-—133 data checks 
IBM 3350 €3330-11 mode) logical volume-—-133 data checks 
IBM 3375 Cnative mode) volume-—-15 data checks 

IBM 3380 Cnative mode) volume-—-15 data checks 


For fixed block architecture device support, this message 
has a different meaning. The 3310 and 3370 each have a very 
high number of alternate blocks that can be assigned by the 
user to bypass data errors in prime blocks. Because the 
number is very high, ANALYZE execution is terminated after 
504 data checks have been logged on the system printer. 
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FIXED HEAD ERROR TABLE 


HEAD NUMBER DATA CHECK SEEK VERIFY HEAD NUMBER DATA CHECK SEEK VERIFY 
CHECK 


Figure 4. 
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The Fixed Head Error Table 


DATAVER DATA CHECK ADDR 


This error is detected when the data verification test 
detects a data check. For the 3344 and 3350 the logical 
volume's cylinder, CC, and head, HH, are printed to indicate 
the track on which the data check occurred. These are 
hexadecimal values that indicate the logical, rather than 
physical, address on the logical volume. For the 3310 and 
3370, ADDR is the failing relative block number for the 
device. Each data check detected by the data verification 
test is described with this message. 


This message may also be printed when a drive error that 
would normally have been detected during the drive tests 
occurs during the data verification test. The condition that 
caused the drive error is usually intermittent or marginal, 
and was not detected during the drive tests. You can examine 


the sense bytes to determine whether a data eee or another 


type of error occurred. 
DATAVER DATA FORMAT UNACCEPTABLE ON CYL xx 


This error 75 devectod during the data verification test 


when one of the following conditions occurs on a count key 


data device: 


~ The test determines that the data on the identified 
cylinder is written in a format other than the IBM 
standard format. This is the usual cause of the message. 
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= A drive error (such as dropping ready) occurred during 
the test. The condition that caused the drive error is 
usually intermittent or marginal, and was not detected 
during the drive tests. 


- When the volume under test is also accessed by another 
program, the other program erased an end-of-data record 
after it had been read by the data verification test and 
before it had been read again by the test. This is a 
possible, though unlikely, situation. 


The volume'ts logical cylinder address, a hexadecimal value, 
iS printed with the message. To determine more accurately 
the cause of the message, you can examine the sense 
information and the CSW Cif it is printed with the message). 
If an intermittent drive error occurred, the sense 
information can be used to analyze it. 


In addition to the diagnostic messages, ANALYZE produces 
tables that summarize errors associated with the read/write 
circuitry that occurred during the drive tests: the movable 
head error table (shown in Figure 3 on page 33), and the 
fixed head in Figure 4 on page 34. | 


Nota: The fixed head error table may be printed even though the 
drive under test does not include the fixed-head feature. In 
that case, the table applies to movable heads 00 through 29. 


DRIVE TEST MESSAGES 


During the drive test, diagnostic messages are issued on the 
system printer for each error detected during execution of a 
channel program. If a channel program has not completed 
successfully, an appropriate diagnostic message is issued. 


A diagnostic message identifies by name the test in which the 
failure occurred, and is followed by information appropriate to 
describing the error, such as a display of the failing CCW, the 
CSW at the time of failure, and the sense bytes. Figure 5 shows 
the diagnostic messages and their meanings of each message. 


Diagnostic Message Issued Meaning 


FIXED BLOCK CALIBRATION An error is detected during an 

SEEK TEST: BCALSK attempt to move the access arm 
from block 244 to a specified 
location and back again to 
read. 


FIXED BLOCK HEAD SEEK An error is detected during an 
TEST: BHDSK attempt to write multiple 


blocks and seek to the next 
sequential track. €3310 only) 


FIXED BLOCK INCREMENTAL An error is detected during an 
SEEK TEST: BINCSK attempt to switch heads ran- 
‘| domly to read. 


FIXED BLOCK SERVO SEEK An error is detected during an 
TEST: BSRVOSK attempt to write and read back 
| block 244 of the CE area. 


FIXED BLOCK DATA COMPARE An error is detected when the 

FAILED: BWRCE 7 record read did not compare 
equally with the same record 
previously written. 


Figure 5 (Part 1 of 3). Drive Test Diagnostic Messages 
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| Diagnostic Message Issued 


FIXED BLOCK READ PREFOR- An error is detected during an 
MATTED BLOCK TEST: BWRNFEPS attempt to read block 296 of 
the CE area (3370 only) 


An error is detected during an 
attempt to write multiple 
blocks in the CE area. (3370 
only) | 


FIXED BLOCK WRITE PRESE- 
LECTED BLOCKS TEST: 
BWRNFP 


An error is detected when ANA- 
LYZE has completed its test 

and an error occurs during the 
cleanup of track 1 on the CE 
cylinder. 


CLEANUP TEST: CLEANUP OF 
C. E. CYLINDER TRACK 0 
FAILED 


(sea note) 


An error is detected when a 
drive error caused the wrong 
record to be read. 


RDMT DATA COMPARE TEST: 
KIRONG RECORD READ (see 
note) | 


RDMT TEST: MULTI-TRACK 
READ IN C. E. CYLINDER 
FAILED (see note) 


RECAL TEST: RECALIBRATE 
TO CYL 0 HEAD 0 FAILS 
(sea note) 


An error is detected when ANA- 
LYZE attempts to read records 
on the CE cylinder. 


An error 18 detected when ANA- 
LYZE attempts to recalibrate 
the access arm to cylinder 0, 
head 0 and fails. | 


RHA HA INCORRECT: HOME 
ADDRESS DATA READ IS 
INCORRECT 


RHA TEST: READ HOME 
ADDRESS ON C.E. CYLINDERS 
FAILEDC see note) 


An error is detected when ANA- 
LYZE reads a home address oth- 
er than the one expected. 


An error is detected when 
LYZE attempts to read the CE | 
cylinder's home address and 
fails. 


An error is detected when ANA- 
LYZE attempts to read all the 
home addresses under the fixed 
heads and fails. 


RHAFH TEST: READ HOME 
ADDRESS UNDER FIXED HEADS 
FAILED (see note) 


RHAMH TEST: READ HOME 
ADDRESS UNDER MOVEABLE 
HEADS FAILED (see note) 


An error is detected when ANA- 
LYZE attempts to read home 

addresses under all the mova- 
ble heads and fails. 


RPS ERROR: READ SECTOR OR 
SET SECTOR FAILED (see 
note) 


An error is detected when ANA- 
LYZE attempts to read sector 
or to set sector and fails. 


An error is detected when ANA- 
LYZE attempts to move the 
access arm incrementally and 
fails. 


SKINCR TEST: INCREMENTAL 
MOVEMENT OF ACCESS ARM 
FAILED (see note) 


An error is detected when ANA- 
LYZE attempts to move the 
access arm from cylinder 0 to 
the maximum cylinder address 
and fails. 


SKMAX TEST: SEEK FROM 
CYLINDER 0 TO MAXIMUM 
CYLINDER FAILED (see 
note) 


Figure 5 (Part 2 of 3). Drive Test Diagnostic Messages 
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Diagnostic Message Issued Meaning 


An error is detected when ANA- 
LYZE attempts to move the 
access arm "randomly" from one 
cylinder address to another 
and fails. 


SKRAN TEST: RANDGM CYLIN- 
DER ACCESS FAILED (sea 
note) 


SNS TEST: ERROR IN SENSE 
CCW Csee note) 


An error 1s detected when ANA- 
LYZE attempts to obtain sense | 
information and fails. 


An error is detected when ANA- 
LYZE attempts to write records 
0 and 1 on the CE cylinder and 
fails. 


WRT TEST: WRITE RECORDS 
RO and RI ON C.E. CYLIN- 
DER FAILED (see note) 


An error is detected when ANA- 
LYZE attempts to write a 
record and fails because the 
"R/W" or "READ" switch is in 
the "READ" position, or the 
| "READ/WRITE™ switch position 
| 18 defective. 


WRTPAD READ WRONG RECORD An error is detected when ANA- 

| LYZE attempts to write a 
record using the write count, 
key, and data command, and 
read it back. The record read 
back (which should have been 

| overwritten with zeros) was 

: not as expected. 


WRTPAD TEST: WRITE COUNT, | An error is daee- vec when ANA- 


¥** WRITE INHIBIT SWITCH 
ON 


KEY, DATA FAILED (Csee LYZE attempts to write a 
note) | record using the write count, 
1 key, and data command and 


fails. 


Figure 5 (Part 3 of 3). Drive Test Diagnostic Massages 


Note to Fioure 5 on pade 35 


The diagnostic message is followed by: 


CSW = RAAKKAh AhRR_AAHh CCH = hhhhhhhh hhhhhhbh SENSE = hhhhhhhh 
hhibhhhhh hAhAnKKHA hhARAhHA hhahhhhh AhhAhhhhh where CSW = is 
followed by 7 bytes of the failing CSW in hexadecimal digits, 
CCW = is followed by &8 bytes of the failing CCW in hexadecimal 
digits, and SENSE = is follewed by 24 bytes of the sense 
information jap Laged in hexadecimal digits. For detailed 
information on the sense information, see the reference manuals 
listed in the Preface. 


MOVABLE AND FIXED HEAD ERROR TABLES 


In addition to the diagnostic messages, if errors associated 
with the read/write circuitry occurred during the drive test, 
ANALYZE produces two tables to summarize the errors; a movable 
head error table and a fixed head error table. These tables are 
printed on the system printer after all tests are completed. 
Figure 3 on page 33 shows the format of the movable head error 
table. The physical heads or tracks are listed in the first 
column on the left. A character 'X* i185 placed in the column 
corresponding to the type of error detected for a particular 
head. Figure 4 on page 34 shows the format of the fixed head 
error table. The first column of the left group and the first 
column of the right group list the physical head or tracks. A 
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character 'X' is placed in the column Cree one ny to the type 
of error detected for a particular head. 


The fixed head error table could be printed for a 3350 in native 
or compatibility mode even if the fixed head feature were not 
specified. This may happen if an intermittent error occurred on 
the movable heads during the fixed head test. If this occurs, 
sea the conversion table in Figure 6 to determine which physical 
movable head number corresponds with the fixed head number in 
the fixed head error table. 


Haad Number Fhysical — Head Number Physical 


From Fixed Movable | From Fixed iovable 
Hoad Error Head Number Head Error Head Number 
Table Table 
33503 3330 3350 3330 
(compatibility fae eee 
modes)? modes) * 
0 0 20 30 0 ll 
1 1 Ed 31 1 12 
2 2 22 32 2 13 
3 3 Zs 35 3 14 
4 4 24 34 Gq i5 
5 5 25 35 5 16 
6 6 26 36 6 17 
7 7 af 37 7 18 
8 8 28 38 & 0 
9 9 29 39 3 ] 
10 10 20 40 10 2 
11 il ol 4] 11 3 
12 12 22 42 12 4 
13 13 23 43 13 5 
14 14 24% 44 14 6 
15 15 25 65 15 7 
16 16 26 46 16 8 
17 17 oa | &7 17 $ 
18 18 28 48 18 10 
19 19 0 49 19 11 
20 20 1 50 20 12 
2d 2i 4 SI 21 13 
Ze Ze 3 52 | | oe 14 
23 23 4 53 23 15 
2% 24 5 54 24 16 
25 25 6 55 25 17 
26 — 26 7 56 26 13 
27 a7 8 57 27 Unused 
28 | 28 9 58 28 Unused 
29 29 10 59 29 Unused 


1 The head numbers listed below are on physical cylinder 1. 

2 The first 10 head numbers listed below (20-29) are on physical cylinder 0. 
The next 20 head numbers (20-28 and 0-10) are on physical cylinder 1. 

3 The head numbers listed below are on physical cylinder 2. 

* The first 8 head numbers listed below (11-18) are on physical cylinder 1. 
The next 19 head numbers (0-18) are on physical cylinder 2. 


Figure 6. Mapping of Fixed Head Numbers to Physical Movable Head Numbers if 
Fixed Head Feature Not Present 
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During the data verification test, diagnostic messages may be 


issued on the system printer 


if an error is detected. See 


Figure 7 for a list of messages that may be issued and their 


meanings. 


Diagnostic Message Issued 


DATAVER DATA CHECK ADDR = 
hhhh hhhh Csee Notes 1 
and 2) 


DATAVER DATA CHECKS 
EXCEEDED THRESHOLD 


DATAVER DATA FORMAT UNACC 
EPTABLE ON CYL KWhhh Ahhh 
(See Notes 1 and 2) 


DATAVER TEST: ERROR DUR- 
ING DATA VERIFICATION 
(see Note 2) 


DATAVER PERMANENT ERROR 
ADDR = hWhhh hhhh Csee 
Notes l and 2) 


DATAVER TEMPORARY ERROR 
ADDR = Whhh hhhh Csee 
Notes 1 and 2) 


Meaning 


A data check was detected dur- 
ing the data verification 
test. The probable cause was a 
media problem but a drive 
error may have occurred. The 
condition that caused the 
drive error is intermittent or 
marginal and was not detected 
during the drive test. 


For CKD devices, the number of 
tracks with data checks for 
the devica has exceeded the 
number of alternate tracks on 
the volume. For FBA devices, 
the number of data checks 
exceeded the arbitrary limit 
of 504. 


For CKD devices, data on the 
cylinder is written in a for- 
mat other than the IBM stand- 
ard format, or an intermittent 
drive error occurred during 
the data verification test, or 
the volume under test was 
accessed by another program 
and the other program erased 
an EOD record after it has 
been read by the data verifi- 
cation test and before it has 
been reread by the test. 


A drive error was detected 
during the data verification 
test. 


A drive error was detected 
during the data verification 
test. 


A drive error was detected 
during the data verification 
tast. 


Figure 7. Data Verification Test Diagnostic Messages 


Notes to Fiqure 7: 


1. The logical volume's cylinder and head are represented by 
hhhh hhhh. This value is in hexadecimal. 


The diagnostic message is followed by: 


CSW = Khhhhh hhhhhhhh CCW = Hhhhhhhh hhhhhhhh SENSE = 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh where 
CSW = 1s followed by 7 bytes of the failing CSW in 
hexadecimal digits, CCW is followed by 8 bytes of the 
failing CCW in hexadecimal digits, and SENSE = is followed 
by 24 bytes of the sense information received in hexadecimal 


digits. 


ANALYZE: Analyzing a Volume 39 


BUILDIX 


BUTLDIX: 


BUILDING A VTOG INDEX 


Direct access volumes in the OS/VS environment may optionally be 
changed from the 0S format VTOC (COSVTOC) to the indexed format 
VTOC CIXVTOC) by invoking the BUILDIX command. BUILDIX will 
build a VTOC index data set and prepare the VTOC to show that 
the volume is in IXVTOC format. BUILDIX will also change a 
volume in IXVTOC format to OSVTOC format. 


To build an index data set on a volume, the BUILDIX command 
requires that the host system contain indexed VTOC programming 
support. Execution of the command will terminate without action 
if this support is not present. 


"Appendix E. The VTOC Index" on page 157 contains more 
information about indexed format VTOCs. 


Note: The BUILDIX command is a valid command only in the OS/VS1 
and OS/VS2 MVS environments. 


DEVICES SUPPORTED BY THE BUILDIX COMMAND 


SYNTAX 


All real devices supported by the host OS/VS operating systam 
are supported by the BUILDIX command with the exception of the 
2314 direct access storage device. MSS virtual volumes (3330V) 
are also supported by the BUILDIX command. VM/370 users who IPL 
an indexed VTOC supporting operating system can use BUILDIX to 
format minidisks and attached volumes by submitting batch jobs 
to their virtual machine. 


Volumes containing split cylinder extents are not supported by 
the BUILDIX command. DOS volumes will be converted to OSVTOC 
format or to IXVTOC format, according to the parameters 
specified. 


Required Parameters 


DDNAME Cdname) 
IXVTOC|OSvTac 


Optional Parameters | 


PURGE | NMOPURGE 


Command ; 


BUILDIX 


DDNAME: IDENTIFYING THE DEVICE OQN WHICH THE VOLUME IS MOUNTED 


Explanation: DDNAMECdname) must be specified to identify the 
volume whose VTOC is to be changed. 


DDNAMNE 7 
Required when a volume is mounted online. The device on 
which the volume is mounted must be online and the volume 
mounted as PRIVATE with DISP=OLD specified. 


For dname, specify the 0S/VS JCL DD statement that 
identifies the device on which the volume is mounted. 


40 Device Support Facilities User's Guide and Reference 


IXVTOC |OSVTOC: 


BUILDIX 


Abbreviations: 
DDNAME | DNAME 
Restrictions: None. 


Defaults: None. 


IDENTIFYING THE BUILDIX FUNCTION TO BE EXECUTED 


Explanation: IXVTOC or OSVTOC must be specified to identify the 
BUILDIX function to be executed. 


IXVTOC 
Causes an OS/VS format VTOC to be changed to the indexed 
format. 


OSVTCC 
Causes an indexed VTOC to be changed to an OS/VS format. 


Abbreviations: 


IXVTOC|IX 
osvToc{oas 


Defaults: None. 


Restrictions: IXVTOC may only be specified if indexed VTOC 
programming support is part of the host system. Command 
exacution will terminate with no action taken, if this support 
18 not available. 


PURGEINOPURGE: 5 


SFECIFYING DISPOSITION OF THE INDEX DATA SET 


Explanation: PURGE|NOFURGE are optional parameters describing 
the final disposition of the index data set when changing an 
indexed VTOC to an OS/VS format VTOC. 


PURGE 
Causes deletion of the index. 


NOPURGE 
Causes the index to be left on the volume. 


Abbreviations: 


PURGE|PRG 
NOPURGE | NOPRG 


Default: NOPURGE. 
Restrictions This parameter is valid only when changing from an 


indexed VTOC to an OS/VS VTOC. If specified with the parameter 
IXVTOC, the option is ignored. 


BUILDIX: OSVTOC TO IXVTOC 


If changing to an indexed VTOQC, before invocation of BUILDIX you 
must preallocate the index data set in a separate job or job 
step; or you must provide a DD card describing the index data 
set in the same job step so that the scheduler will cause 
allocation of the index before command execution begins. 
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BUILDIX 


You must ensure that the name of the index data set begins with 
the characters "SYSI1.VTOCIX." and must provide a unique 
third-level qualifier for each index data set in your 
installation. The recommended convention is | 
"SYS1.VTOCIX.volser," which ensures that all online volumes have 
uniquely identified index data set names. This prohibits ENQ 
lockouts on all other volumes needing IXVTOC service functions 
to be performed. The name "SYSI1.VTOCIX." is a reserved name in 
systems supporting the indexed VTOC, and only one data set per 
volume may begin with this prefix. 


Space for the index must be reserved in one continuous extent. 
This can be accomplished by allocating the index by absolute 
track or by specifying the CONTIG subparameter for all other 
requests. The amount of space to reserve for the index is | 
device-dependent, as well as dependent upon the size Cin tracks) 
of the VTOC. A reference table to aid in determining how much 
space to reserve for the index is found in Appendix E. 


BUILDIX: IxvToc TO OSVTOC 


This function will allow you to change an IXVTOC to an OSVTOC. 


You are provided an option to leave the index allocated 
CNOPURGE) or to delete it CPURGE). The option to leave it 
ensures that, if the volume should be changed again to the 
IX¥TOC format, no calculation as to size and optimum location 
would be necessary. This convenience is realized when an IXVTOC 
volume is temporarily transported to a location that does not 
have programming support for the indexed VTOQC and is then 
returned to a location having such support. 


The procedure to follow when transporting IXVTOC volumes to 
nonindexed VTOC systems is to prepare the volumes prior to their 
removal from the indexed VTOC system by executing BUILDIX and 
specifying the OSVTOC parameter. Upon return of a volume, 
BUILDIX is again executed, if desired, to rebuild the index. 


Care must be exercised if IXVTOC volumes are to be temporarily 
transported to nonindexed VTOC systems. If the volumes are not 
changed to OSVTOC format prior to being transported, serious 
errors may result when the volumes are returned to the indexed 
VTOC system. DADSM functions performed by the nonindexed VTOC 
system on the VTOC do not always force reconstruction of the 
VTOC to OSVTOC format. VTOC changes not causing reconstruction 
of the VTOC ara not recorded in the index and, in effect, 
invalidate the index. 


EXAMPLES OF WAYS TO CODE THE BUILDIX COMMAND 
The following examples illustrate ways in which the BUILDIX 
command might be coded ina variety of situations. 


The axamples show the job control language statements you will 
need when invoking the BUILDIX command. 


Note that the content of the data definition statement varies 


according to the function to be executed. The examples show 
various specifications of the statement. 
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BUILDIX 


CHANGING AN IXVTOC TO AN OSVTOC: EXAMPLE 1 


In t 
iden 
stat 


// 
// 
// 
/7/ 
Sf 
“7 

B 
/% 


he following example, a 3330 volume having the volume 
tification VL3330 1s to be changed to OSVTOC format. The DD 
ement simply identifies the volume. 


jobname JOB «ss 
stepname EXEC PGM=ICKDSF 


SYSPRINT DD SYSOUT=A 

DDCARD DD UNIT=(3330,,DEFER),VOL=CPRIVATE,SER=VL3330), 
DISP=OLD 

SYSIN DD x 

UILDIX DDNAMECDDCARD) OS NOPURGE 


UNIT=€3330,,DEFER) specifies that mounting of the volume on 
the 3330 device type is to to be deferred to prevent other 
users from sharing the volume. 


VOL=CPRIVATE,SER=VL3330) identifies the volume and specifies 
a private mounting to prevent use of the volume for 
temporary data sets. 


DISP=OLD specifies that allocation routines will check the 
mount status of VL3330 and issue appropriate messages to the 
operator. 


Specification of NOPURGE in the BUILDIX command statement 
indicates that the index is to be left allocated. If NOPURGE 
were not specified, the command statement would have the 
same effect, since NOPURGE is the default. Specification of 
PURGE, as in the following command statement, would cause 
the index to be deleted. 


BUILDIX DDNAMECDDCARD) OSVTOC PURGE 
Note: Whether the index is purged or left allocated is 


controlled by command parameters. Disposition of the index 
data set must not be specified in the DD statement. 


BUILDING A VTOC INDEX ON A VOLUME WITHOUT AN INDEX ALLOCATED: EXAMPLE 2 


This option requires additional parameters on the DD statement 


LO 
data 


4/7 
47 
17 
// 
// 
// 
// 

B 
/* 


ause allocation of the index. The statement must contain 
set information for the index. 


jobname JOB: ec. % 

stepname EXEC PGM=ICKDSF 

SYSPRINT DD SYSOQUT=A 

VOLDD DD UNIT=(€3330,,DEFER),VOL=CPRIVATE,SER=VL3330), 
DSN=SYS1.VTOCIX.VL3330,DISP=C(NEW,KEEP), 
SPACE=CABSTR,(€10,1))3) 

SYSIN DD X 

UILDIX DDNAMECVOLDD) IXVTOC 


DSN=SYSI1.VTOCIX.VL3330 specifies the name of the index data 
set. The third-level qualifier, VL3330 (the volume serial), 
follows the recommended convention for naming the index. 


DISP=(NEW,KEEP) directs the system allocation routines to 
allocate the data set prior to execution of Device Support 
Facilities commmands and to retain it upon termination of 
the task. 


SPACE=CABSTR,(€10,1)) directs the allocation routines to 
allocate a ten-track index starting at track one. ABSTR is 
specified in the space request to ensure that the index 
space 15 a single continuous extent and is in the location 
desired by the user. If location 15 not a primary concern, 
space can be reserved by specifying SPACE=C(TRK,10,,CONTIG). 
Uae ata glia ten contiguous tracks to be reserved at some 
ocation. 
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BUILDIX 


BUILDING A VTOC INDEX ON A VOLUME WITH AN INDEX ALLOCATED: EXAMPLE 3 


In this example, the volume identified as VL3330 was changed to 
an OS/VS format at some time, either by the user or by a system 
routine that disabled the index and changed the VTOC to OSVTOC 
format. The index data set was left allocated on the volume. The 
DD statement required to change again to an IXVTOC is shown. 


//jobname JOB 2 « « 
//stepname EXEC PGM=ICKDSF 
//SYSPRINT DD SYSOUT=A 


//NOLDD DD UNIT=(€3330,,DEFER),VOL=CPRIVATE,SER=VL3330), 
//f DSN=SYS1.VTOCIX.VL3330,DISP=OLD 
S/SYSIN DD X 
BUILDIX DNAMECVOLDD) IX 
1% 


° DISP=OLD specifies that the data set exists. 
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INIT 


INIT: INITIALIZING A VOLUME 


A direct-access storage volume must be initialized before an 
operating system can use it. The INIT command can initialize 
count key data volumes at minimal, medial, and maximal levels, 
and fixed block architecture CFBA) volumes at minimal and 
maximal levels, by specifying parameters that control the level 
of initialization. These several levels of initialization are 
described in the sections that follow. 


INITIALIZING A VOLUME AT THE MINIMAL LEVEL 


| Count-Key-Data Davices 


A volume is initialized at the minimal level when both the 
NOVALIDATE and NOCHECK parameters are specified. 


Minimal initialization creates the contents of cylinder 0, track 


0 by: 
° Writing IPL bootstrap records as records 1 and 2 
e Writing a volume label as record 3 


and reserves tracks for the VTOC at the location specified by 
the user and for the number of tracks specified. If no location 
is specified, tracks are reserved at the default location. 


If the INDEX parameter of the INIT command is specified, a 
format-1l1 DSCB is built in the VTOC with the default data set 
name of SYS1.VTOCIX.volser. If the volser begins with a numeric 
character, the default data set name will be SYSI.VTQCIX.Veeccc. 
For example, if the volser 1s 333061 the default data set name 
written in the format-l DSCB is SYSI.VTOCIX.V33001. “Appendix E. 
The VTOC Index" on page 157 contains more information about 
indexed format VTOCs. 


Alternate tracks are checked for defective-track fladqs. If the 
defective-track flag 1s ON for an alternate track Cindicating 
that it is, itself, defective), and if the associated primary 
track is still flagged defective, a nondefective alternate track 
1S assigned to the primary track. 


Primary track surfaces are not checked. Primary tracks that are 
associated with alternate tracks are assigned nondefective 
alternate tracks. If a primary track is incorrectly associated 
with an alternate track, or is flagged defective but not 
associated with an alternate track, an error message is issued. 


| Fixed Block Architecture Devices 


For fixed block architecture (FBA) volumes, initialization is 
performed at the mimimal level when the NOCHECK option is 
specified. Minimal initialization does the following: 


| « The volume labels and VTOC are formatted 


the number of tracks specified. If you do not specify the 


! Tracks are reserved for the VTOC at the location you specify for 
location, tracks are reserved at the default location. 
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INIT 


INITIALIZING A VOLUME AT THE MEDIAL LEVEL 


| Count-Key-Data 


INITIALIZING A 


| Count-Key-Data 


Devices 


ih Wel Unie Geant bial ¢eed et the medial. Favel wher botn-ehe 
VALIDATE and NOCHECK options are specified. 


Medial initialization includes the actions of minimal 
initialization, as well as validation of the existence and 
content of each track's home address and record 0. Validation 
ensures that the proper track address (cylinder and track) 
appears in both the home address and record 0 on each track, and 
that a standard record 0 exists on each track. When initializing 
3350 volumes to convert from native mode to 3330-compatible mode 
volumes or the reverse, validation rewrites the home address and 
record 0 on each track. 


The alternate track area is compressed and new alternates will 
be assigned for defective primary tracks. The flag byte in the 
home address for each primary track is examined and, when the 

defective-track flag is ON, an alternate track is assigned for 
the primary track. 


VOLUNE AT THE MAXIMAL LEVEL 


Devices 


A volume is initialized at the maximal level when the CHECK 
parameter 15 specified. 


Maximal initialization includes the actions of minimal and 
medial initialization, as well as checking of track surfaces. 


Skip displacement analysis is performed for 3375 and 3380 


devices if surface checking detects a data check on the volume. 
The primary track continues to be used until the number of 


defects exceeds the maximum allowed and an alternate track 15 
then assigned. In addition, skip displacement analysis is 
automatically performed for cylinder 0 track 0 and the first 


track of the VTOC (before the volume label or the format-~¢4 DSCB 
is written). If possible, all defects are skipped on these 
tracks. If this is not possible (more than the maximum allowable 


defects), an alternate track is assigned. See “Appendix G. 
Surface ADS sy a) on page 164— for more ee aeeO on surface 


een 


| Fixed Block architecture Davices — 


For fixed block architecture CFBA) volumes, initialization is at 
the maximal level when the CHECK parameter is specified. At this 


level, each block is surface checked for recording errors and 


any blocks that have errors have new alternates assigned. The 
volume labels and VTOC are then formatted. 


If you specify RECLAIM with CHECK, an attempt is made to reclaim 
the primary surface of blocks that have had alternates assigned 
by prior INIT or INSPECT command executions. Any blocks that 
were previously marked defective by an INIT or INSPECT execution 
but pass the surface analysis test in this run, are marked 
available. However, any primary or alternate blocks that were 
flagged defective by the factory cannot be reclaimed by the INIT 
command. 


The FBAVTOC parameter is used to specify the space for the VTOC 
for an FBA. device. This parameter allows you to specify the 
beginning block number, number of label records, and control 
interval size of the VTOC. See “Appendix F. The Fixed Bleck 
Architecture VTOC CFBAVTOC)™ on page 161 for more information on 
the FBA VTOC. 
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SYNTAX 


RESS |[DDNANEISYSNAME: 


INIT 


Required Parameters 
UNITADDRESS (cuu) | 
PENAMECdname) | 
SYSNANECsysxxx) 
VERIFYCseriall,owner]) | 

NOVERIFY 


Optional Parameters 


DEVICETYPEC devtype) 
PURGE | NOPURGE 
CHECK (n) HOSHECK 


VALIDATE | NOVALIDATE 

RECLAIN|NGORECLAIM 

VTOCCcylinder, trackLl,extent]) 

DOSVTOC 
C(cylinder,track[,extent]) 

FBAVTOC(rbnl,extentl,cisize]]) 

INDE 
(cylinder,trackl,extent]) 

VOLIBDCserial) 

OHNNERTIDCouner ) 

LASELS (Cn) 

TPLDD( {dname]dlblname} 
L,OBJFORMAT!|, ABSFORMAT)) 

BOCTSTRAP |ROROOTSTRAP 

NIHICCdevtype) 

HAP |NOMAP 


IDENTIFYING THE DEVICE ON WHICH THE VOLUME TS 


Explanation: UNITADDRESS(cuu) IDDNAMNE(Cdname) |SYSNAME(Csysxxx) are 
required parameters identifying the volume that 1s to be 
initialized. When you initialize a volume for the first time 
under OS/VS or DOS/VSE, the volume must be mounted offline 
because it contains no volume label and is not acceptable to an 
operating systam. 


UNZTADDRESS 
Required when initializing a volume that is mounted offline 
or when initializing a volume in a stand-alone environment. 


For cuu, specify the address, in hexadecimal, of the 
channel and unit on which the volume is mounted. 


Note: The device must be on a channel that is online. If 
the device 1s on a channel that is offline, the program 
might enter a nonterminating wait state. 


DDNANE 
Required when initializing a volume that is mounted online 
in the OS/VS environment. The device on which the volume is 
mounted must be online and the volume mounted as PRIVATE 
with DISP=OLD specified. 


For dname, specify the OS/VS JCL DD statement that 
identifies the device on which the volume is mounted. 


SYSNANE 
Required when initializing a volume in the DOS/VSE 
environment. For sysxxx, specify the SYSNAME specified in 
the ASSGN control statement. 
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INIT 


Abbreviations: 


UNITADDRESS|UNIT 
DDNAME|DNAME 


Restrictions: The UNITADDRESS parameter cannot be. specified uhen 
initializing a volume that is mounted online. i 


The DDNAME parameter cannot be specified when initializing a 
volume that has not been previously initialized or when the 
volume is in a stand-alone environment or the DOS/VSE 
environment. 


The SYSNAME parameter cannot be specified when initializing a 
volume in the stand-alone or OS/VS envirenment. 


; SERIAL NUMBER AND GUNER IDENTIFICATION 


Explanation: VERIFY(serial L,owner])|NOVERIFY are required 
parameters specifying whether to verify the volume serial number 
and owner identification before initializing the volume. 


VERIFY 
Required when you want to verify the volume serial number 
and owner identification before initializing the volume, If 
the volume serial number or owner identification does not 
match that found on the volume, the INIT command 
terminates. 3 


For serial, substitute one to six alphameric characters for 
the volume serial number. 


For owner, substitute one to fourteen alphameric characters 
for the owner identification. 


NOVERIFY 


Required when you want to bypass verification af the volume 
serial number and owner idantification. 


Abbreviations: 


VERIFY |VFY 
NOVERIFY|NOVFY[NVFY 


Befaults: None. 

Restrictions: You cannot verify the owner identification 
separately from the volume serial number; both the volume serial 
number and the owner identification must be verified when you 
want to verify the owner idantification. 


When you specify the VERIFY parameter and verification fails, 
the command terminates. 


DEVICETYPE: IDENTIFYING THE TYPE OF DEVICE 


Explanation: DEVICETYPE(devtype) is required in a standtalone 
environment when the MIMICCMINI) or MIMICCEMU) parameter js 
specified. 


For devtype, substitute one to eight characters for the type of 
device on which the volume is mounted. See Figure 2 on page % 
for valid device types. 

Abbreviations: 


DEVICETYPE|DEVTYPE|DEVTYP 
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PURGE | NOPURGE: 


INIT 


Defaults: None. 


Restrictions: The DEVICETYPE parameter applies only when you 
are initializing a volume in a stand-alone environment and 
MIMICCMINI)D or MIMICCEMU) is specified. If DEVICETYPE is 
specified when it does not apply, it will be ignored. 


When initializing a 3350 Direct Access Storage volume in 
3330-compatibility mode, the device type must be specified as 
33390 or 3330-11, as required. The 3333 Disk Storage and Control 
Models 1 and 11 must be specified as 3330 and 3330-11, 
respectively. 


WRITING OVER DATA ON A PREVIOUSLY INITIALIZED VOLUME 


Explanation: PURGE|NOPURGE are optional parameters that specify 
whether you want to write over the data in the following types 
of data sets during initialization: 


© Unexpired 
e VSAM 
® Password-protected 


° RACF-protected 


PURGE specifies that you want to write over the data. NOPURGE 
specifies that you do not want to write over the data. For more 
information on execution of the PURGE and NOPURGE parameters, 
see the section "Data Set Security and Protection.” 


A volume that appears to contain real data cannot be initialized 
unless the PURGE parameter is specified. 


PURGE 
Indicates that you want to write over existing data during 
initialization. For more information about the actions 
taken when data 1s found on the volume, sea "Data Set 
Security and Protection" earlier in this book. 


NOPURGE 
Indicates that you do not want to write over existing data. 
If a volume appears to contain real data, 1t cannot be 
initialized unless the PURGE parameter 18 specified. 


Abbreviations: 


PURGE|PRG 
NOPURGE|NOPRG|NPRG 


Defaults: The default is NOPURGE. 


Restrictions: The NOPURGE parameter does not apply in offline 
mode or in a stand-alone environment. If you initialize a volume 
in offline mode or in a stand~alone environment, all axisting 
data on the volume is purged, regardless of whether the data 15 
unexpired or password protected. 
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Explanation: For count key date devices, CHECK(n)|NOCHECK are 
optional parameters specifying whether the tracks are to be 
checked for recording errors. Each track is surface checked by 
writing and reading specially patterned records. Upon 
satisfactory completion of surface checking, each checked track 
is rewritten with a standard record 0. If surface checking 
identifies a defective primary track, the track is flagged, and 
an alternate track is assigned to it. If an alternate track is. 
identified as defective, it is flagged as defective and treated 
as unavailable and, if it is associated with a primary track, 
the primary track is assigned a different alternate track. 


For fixed block architecture (FBA) devices, the CHECK(n) |NOCHECK 


parameters are optional parameters specifying whether the blocks 


are to be checked for recording errors. Each block is surface 
checked by writing and reading specially patterned records. If 
surface checking identifies a defective block, the block is 
flagged and an alternate is assigned. - 


CHECK 7 
Indicates that you want each block or track to be checked 
for recerding errors during initialization. This parameter 
erases the contents of each block or track during 
initialization. 


For n, substitute a decimal number from 1 through 10 for 
the number of times you want each block or track to be 
checked. See "“Appandix G. Surface Analysis™ for information 
about n values. | 


For the 3375 and 3380, ICKDSF tries to recover from defects 
on the track by skipping over the defective areas. If more 
than the maximum number of allowable defects are detected, 
an alternate track is assigned. See “Appendix G. Surface 
Analysis" for more information. 


NOCHECK | 
Indicates that you do not want the blocks or tracks to be 
surface checked for recording errors during initialization. 
Abbreviations: 


CHECK | CHK a 
NOCHECK | NOCHK | NCHK 


Defaults: The default is NOCHECK. 


Restrictions: The maximum number you can specify with the CHECK 
parameter is 10. 


Explanation:  VALIDATE|NOVALIDATE are optional parameters 
specifying whether to validate the home address and record 0 for 
each track. Validation is less time-consuming than surface 
checking, but does read and validate the home address and record 
0 on each track. Validation causes the remainder of the data on 
a track to be erased by writing a record 0. 


VALIDATE 

Indicates that you want to validate the home address and 
record 0 for each track during initialization. When you 
specify VALIDATE with the NOCHECK parameter, you initialize 
the volume at the medial level. When you specify VALIDATE | 

with the CHECK parameter, you initialize the volume at the 
maximal level, because the CHECK parameter supersedes the 
VALIDATE parameter. 
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INIT 


NOVALIDATE 
Indicates that you do not want to validate the home address 
and record 0 for each track during initialization. When you 
specify NOVALIDATE with the NOCHECK parameter, you 
initialize the volume at the minimal level. 


Abbreviations: 


VALIDATE! VAL 
NOVALIDATE|NOVALINVAL 


Defaults: The default is NOVALIDATE, unless the CHECK parameter 
is specified. 


Restrictions: The VALIDATE and NOVALIDATE parameters are 
ignored when the CHECK parameter is specified. 


| This parameter is invalid for fixed block architecture devices. 


| RECLAIMINORECLAIM: RECLAIMING BLOCKS OR TRACKS PREVIOUSLY FLAGGED DEFECTIVE 


Explanation: RECLAIM|NORECLAIM are optional parameters 

| specifying whether to reclaim blocks or tracks that were 
previously flagged defective but appear to be usable after 
surface checking. Fixed block architecture devices’ blocks that 
were flagged at the factory are not reclaimed. 


For count key data devices, an attempt is made to reclaim all 
defective tracks. Because surface checking is not as exacting 
as that performed by the manufacturer using special hardware 
analyzers, factory-flagged tracks may be reclaimed. This could 
cause later use of the track to show previously undetected 
defects. 


RECLAIM | 
Indicates that you want blocks or tracks that are 
identified as usable by surface checking to be reclaimed 
during initialization. 


NORECLAIM 
Indicates that you want to suppress block or track 
reclamation during initialization. 


Abbreviations: 


RECLAIM|RCLM 
NORECLAIM|NORCLM|NRCLM 


Defaults: The default is NORECLAIM. 


Restrictions: The RECLAIM parameter applies only when the CHECK 
parameter has been specified. If RECLAIM is specified witn 
NOCHECK, it will be ignored. 


The RECLAIM parameter does not apply when initializing Model 
2305 Fixed Head Storage Models 1 and 2 


VTOC: SPECIFYING THE VOLUME TABLE OF CONTENTS IN OS/VS 


Explanation: vVTOC(cylinder,track[;extent]) is an optional 
parameter specifying the location and size of the volume table 
of contents. 


For cylinder,track, specify one to four decimal (n) or 
hexadecimal (X'n') numbers to identify the cylinder and one to 
four decimal (n) or hexadecimal (X'n') numbers to identify the 
track where the volume table of contents is to be placed. 
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INIT 


For extent, specify one te Five decimal (€n) or hexadecimal 
(X'n') numbers for the number of tracks that are to be reserved 
for the volume table of contents. 

Defaults: The default for cylinder,track is 0,1; when 
initializing a Mass Storage System staging pack, however, the 
default is 0,2. ; 

The default for extent is one track. 


Restrictions: The VTOC parameter is ignored if it is specified 
with the MIMIC(MSS) parameter. 


A VTOC cannot be placed at cylinder 0, track 0. 


| This parameter is invalid for fixed block architecture devices. 


DOSVTOC: SPECIFYING THE VOLUME TABLE OF CONTENTS IN POS/VSE 


Explanation: ndosvTOC(cvlinder,trackl,extent]) is an optional 
parameter specifying the location and size of the volume table 
of contents. 


For cylinder,track specify one to four decimal (n) or 
hexadecimal (X'n') numbers to identify the cylinder and one to 
four decimal (n) or hexadecimal (X'n') numbers to identify the 
track where the volume table of contents is to be placed. 


For extent, specify one to five decimal (Cn) or hexadecimal 
(X'n') numbers for the number of tracks that are to be reserved 
for the volume table of contents. 
Abbreviations: | 

DOSVTOC|DVTOC 
Nefaults: None. 
Rastrictions: If neither VTOC nor DOSVTOC is specified, the 
default taken is an OS/VS VTOC at cylinder 0, track 1, except 
for MSS, where it is cylinder 0, track 2. 
A VTOC can not be placed at cylinder 0, track 0. 


| This parameter is invalid for fixed block architecture devices. 


FRAVTOQC: SPECTFYING THE VOLUME TABLE OF CONTENTS FOR A FIXED BLOCK 
ARCHITECTURE (FBA) DEVICE 


Explanation: FBAVTOC(rbn[,extentl,cisizel]) is an optional 
parameter specifying the starting location, number of label 
records, and control interval size of the volume table of 
contents (VTOC). See "Appendix F. The Fixed Block Architecture 
VTOC CFBAVTOC)”™ on page 161 for more information on the FBA 
VTOC. 


For rbn specify one to six decimal (n) or hexadecimal (X'n') 
characters for the relative block number of the start of the 
VTOC. The range of valid values is: 

| DEVICE RANGE 

| 3310 2 - 126,015 


| 3370 2° SOF e999 
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When you specify a value at the upper limit of the pack, you 
must leave sufficient space for the VTOC itself. For example, 
if you want to format a standard 56-label VTOC at the end of a 
3310 or 3370, respectively, specify, 


FBAVTOC 126000 
FBAVTOC 557984 


volume label blocks (CVLB) respectively. 


For exte specify one to three decimal (n) or hexadecimal 
ie "> rane poe er: for the number of label records in the VTOC. 
The valid range 185 from 3 to 999; however, the number you 
eee is rounded up to an integral multiple of the number of 


| Note that blocks 0 and 1 are reserved for the IPL biock and the 
| labels per control tnterval. 


(X'n') characters for the size of the control interval in bytes. 
The value specified must be an integral multiple of the device's 
physical block size, and must not exceed a value of 86132 


See "Appendix F. The Fixed Biock Architecture VTOC CFBAVTOC)™ on 


For cisize, specify one tc four decimal (n) or hexadecimal 
| page i161 for FBAVTOC format and size calculations. 


| Abbreviations: none 
| Defaults: FBAVTOC(2,56,1024) 


| Rastrictions: This parameter is valid for fixed block 
| architecture devices only. 


for the IPL block and the Volume Label Blocks (VLB) 


| A WTOC can not be placed at blocks 9 and 1, which are reserved 
respectively. 


arenas Ang Se Sin A SER id A on a) 


Explanation: INDEX(€cylinder,track£,extent]) is an optional 
parameter specifying the starting location and size of the index 
data set. Values for subparameters cylinder and track are 
required; specification of extent is optional. 


For cvlinder and track, specify one to five decimal or 
hexadecimal numbers to identify the cylinder number, and one to 
five decimal numbers to identify the track number within the 
cylinder where the index is to start. Hexadecimal numbers may be 
entered by preceding the value with the letter "X" and enclosing 
the hexadecimal number in single quotation marks. 


For extent, specify one to five dacimal or hexadecimal numbers 
for the number of tracks that are to be reserved for the index 
data set. Hexadecimal numbers may also be entered, as for the 
cvlinder and track subparameters. 


Example: INDEX(C10,11,12) This specification will cause the 
incieax to be placed starting at cylinder 10, track 11 for a total 
of 1l2 tracks. Expressed in hexadecimal: INDEXCX'A'’,X'B®,X'C"}> 
Abbreviations: None. 


Defaults: No defaults will be taken for cylinder or track. The 
default for extent is an internal calculation based on the 
number of tracks in the VTOC. 


Restrictions: The 2314, 3310, 3379, and MSS staging volumes are 
not supported by the INDEX parameter. All other devices, 
including VM/370 minidisks, are supported. 


This parameter 15 itgnored in the DOS/VSE environment. 
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VOLID: SPECIFYING THE VOLUME SERIAL NUMBER 


eemanyprne nemaacgannron 


Explanation: VOLID(€serial) is an optional parameter specifying 
the volume serial number to be written in the volume label. 


For serial, substitute one to S1xX alphameric characters for the 
volume serial number. If fewer than six characters are 
specified, the serial is left- a and the remainder of 
the field is padded with blanks (X'40' 


Abbreviations: None. 


Defaults: When you initialize a volume that was previously 
initialized and do not specify the VOLID parameter, the old 
volume serial number remains unchanged. 


Restrictions: When you initialize a volume for the first time, 
you must specify the VOLID parameter, or the INIT command 
terminates. 


If you change the volume serial number of a volume that is 
mounted online, thereafter you must reference the volume by the 
new volume serial number--even though the reference may occur in 
the same step. 


Explanation: QHNERTDCowner) is an optional parameter specifying 
the volume-owner identification to ba written in the volume 
label. 


For owner, substitute 1 to 14 alphameric characters for the 
volume~owner identification to be written in the volume label. 


Abbreviations: 
OWNERIDI OWNER 


Defaults: The default for owner during a first-time 
initialization is 14 blanks. 


If you do not specify OWNERID when reinitializing a previously 
initialized volume, the owner identification remains unchanged. 


Restrictions: None. 


LABELS: RESERVING SPACE FOR ADDITIONAL VOLUME LABELS 


Explanation: LABELS(n) is an optional parameter specifying that 
space on cylinder 9, track 0 is to be reserved for additional 
volume labels, also known as user volume labels. In addition to 
the label that must be written on the volume, a maximum of nine 
additional volume labels can be specified. 


For fixed block architecture CFBA) volumes, space is reserved in 
block 1 for additional user volume labels. In addition to the 
VOL1 label that must be written on the volume, a maximum of five 
additional user volume labels can be specified. 


Nota: A special program module, ICKVLBL, is provided to allow 
you to create the contents of the user volume labels. The module 
is replaced by a user-written module with the same name. The 
microfiche listing for the module contains the information about 
replacing the module. If you do not format the user volume 
labels during initialization, a string of blanks is written in 
each user volume label. . 
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To specify n for count key data devices, substitute a decimal 
number from 1 through 93 for the number of additional user volume 
labels to be placed on the volume during initialization. For 
fixed block architecture devices, the range for n is 1 through 
5 


Abbreviations: 
LABELS|ILABEL|LBL 


Defaults: None. 


Restrictions: If LABELS is not specified, user volume labels 
that existed from a previous initialization are destroyed. 


| For count key data devices, if a value greater than 9? is 
specified with the LABELS parameter, the INIT command 
tarminates. 


For fixed block architecture devices, if a value greater than 5 
is specified, 5 1s used, a message is printed, and the command 
continues. 


The LABELS parameter 1s ignored when the MIMICCMSS) parameter is 
specified. 


IPLOD: WRITING A USER-SUPPLIED IPL PROGRAM ON THE VOLUME 


Explanation: IPLDD( {dnameldlblname}[,OBJFORMAT|,ABSFORMATJ) is 
an optional parameter which allows you to supply an IPL program 
to be written on the volume during initialization. 


The IPLDD and BOOTSTRAP parameters are used to specify one of 
the following: 


© If you do not specify IPLDD, ICKDSF writes special bootstrap 
records that cause the processing unit to be placed ina 
WAIT state if the volume is specified during an attempt to 
load the system. 

® If you specify IPLDD but do not specify BOOTSTRAP, ICKDSF 
supplies an IPL bootstrap which is written on the volume 
during initialization together with the IPL text you supply. 

° If you specify IPLDD and BOOTSTRAP, ICKDSF uses the IPL 
bootstrap and the IPL text you supply. If neccesary, ICKDSF 
updates the bootstrap records to allow for possible user 
labels. 

The maximum size permitted for the IPL program record depends 


upon the type of volume being initialized. The maximum sizes 
allowed are: 


Volume Type Maximum Bytes for IPL Program 


—— 
a 
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Volume Type Maximum Bytes for IPL Program 


3340 : 7,286 
3344, ~—~C~<‘<;«xXL!”*”*”*”:*C«C 
3350 »=)—0—ds |—~—<C~S*sts~sC«S QD 

— | 44,948 


3380 | 


Also, the number of additional user volume labels can further 
limit the size allowed for the IPL program. If you supply an IPL 
program that exceeds the size allowed, you receive an error 
message but initialization continues. 


For dname, substitute 1 to 8 alphameric characters for the DD 
statemant identifying the data set that contains the IPL program 
you Want written on the volume being initialized. The IPL 
program can be included within the OS/V5 JCL input stream 
CSYSIH?. If the IPL program is in the OS/VS JCL input stream, 
the data must be included immediately after the INIT command. 
For initialization in a stand-alone environment, the dname must 
be specified as SYSIN. 


For diblname, substitute 1 to 7 alphameric characters. These 
represent the file name that appears in the DLBL statement and 
identify the file that contains the IPL program you want written 
on the volume being initialized. The IPL program can ba included 
in the DOS/YVSE JCS input stream CSYSIN). It must then be 
included immediately after the INIT command. 


OSJFCRMAT 
Specifies that IPL data 1s being supplied in object deck 
format; that is, cards will have one of the following 
strings of EBCDIC characters in columns 2 through 4: 


TXT 
RLD 
ESD 
END 


Note that only cards with TXT will be processed. All others 
Will be tgnored. 


OBJFORMAT may be abbreviated as OBJECT or OBJ. 


ABSFORMAT 
Specifies that IPL data is being supplied in the form of 
variable-lenath records that contain executable 
instructions. When IPL data is supplied in this format, it 
is necessary to provide a minimum of three records. The 
maximum number of records supplied and their lengths are 
only limited by the track capacity of the volume on which 
these recoras are to be written. 


The first two records supplied must be the bootstrap 
records and are restricted to lengths of 24 and 144 bytes, 
respectively. 


The contents of the IPL records and the contents of the 
program are not checked by ICKDSF. It 18s the user's 
responsibility to ensure that the IPL records can load an 
executable program. The first IPL record must contain a PSW 
followed by two CCWs (channel command words). The CCWs 
should have the following hexadecimal formats: 


First CcW O6xxxxxx 60000090 
Second CCW 08xxxxxx 00000000 
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The first CCW is a command to read in the second IPL record 
at main storage address xxxxxx. The second CCW is a 
transfer-in-channel command Ca branch) to the CCW that 
begins the second IPL record. 


The second IPL record must be 144% bytes long. Bytes 32 
through 42 (starting from byte 0) cannot be used. Bytes 32 
through 42 are used by ICKDSF for the seek address (bytes 
32 through 37) and the CCHHR Cbytes 38 through 42) of the 
third IPL record. 


The third through nth records that are supplied are assumed 
to be IPL program records and will be written on the 
volume, without any modification, after the standard volume 
label and any existing user volume labels. Note that the 
IPL program will’ only be written on the first track of the 
pack. If the records supplied exceed in length the 
remaining space on the first track, the function will 
terminate with an error message. 


ABSFORMAT may be abbreviated as ABSOLUTE or ABS. 
Abbreviatians: 
IPLDDI IPL 


Defsults: The system provides special IPL bootstrap records if 
you specify the IPLDD parameter without specifying the BOOTSTRAP 
parameter. 


Restrictions: The IPLDD parameter is ignored when the MIMICCMSS) 
parameter 1s specified. 


To initialize a volume ina epand=a lene environment, you must 
substitute SYSIN for the dname. 


When an IPL program is included in the SYSIN stream, it must 
immediately follow the INIT command and be terminated by an 
ENDIPLTEXT card. The ENDIPLTEXT card is optional when the IPL 
program 15 in a data set other than the one specified by SYSIN, 
or when the end-of-file indicator (/*) immediately follows the 
data for the IPL program. 


This parameter 15 invalid for fixed block architecture devices. 


WRITING IPL BOOTSTRAP RECORDS CN THE VOLUME 


Explanation: BOOTSTRAP|NOBOOTSTRAP are optional parameters 
specifying whether you are supplying the IPL bootstrap records 
that are to be written on the volume during initialization. 


ECOTSTRAP 
Indicates that you are supplying the IPL bootstrap records 
that are written on the volume during initialization. These 
records must be the first four records in the IPL program 
text. The first text record must have IPL1 in the first 
four columns, followed by 24 bytes of data. These 24 bytes 
have the same format as the first IPL record described 
above under ABSFORMAT. The next three text records must 
have IPL2 in their first four columns, followed by 68 bytes 
of data each in the second and third records and 8 bytes of 
data in the last record. These 144 bytes of data have the 
same format as IPL record 2 described above under 
ABSFORMAT. 


NOBOOTSTRAP 
Indicates that you want the system to supply the IPL 
bootstrap records that are written on the volume during 
initialization. 
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Abbreviations: 


BOOTSTRAP | BOOT 
NOBOOTSTRAP |NOBOOT|NBOOT 


Defaults: The default is NOBOOTSTRAP. 


Restrictions: The BOOTSTRAP and NOBOOTSTRAP parameters apply 
only when the IPLDD parameter is specified. This parameter is 
ignored when the IPL program is supplied in absolute format. 


| This parameter is invalid for fixed block architecture devices. 


MINTC: SPECIFYING A SPECTAL VOLUME USAGE FORMAT 


Explanation: MIMIC(devtype) is an optional parameter specifying 
a special usage format for the volume being initialized. You can 
specify MINICn), MSS, EMUCn), or EMUALL. 


MIRICn) 
Indicates that an OS/VS minidisk is to be initialized for a 
VM7370 environment. n represents the number of cylinders 
that are to comprise the minidisk. Details of this support 
are in Appendix B. | 


MSS 
Indicates that the volume is to be formatted as a Mass 
Storage System staging pack. A one-track volume table of 
contents 1s created on cylinder 0, track 2 with a format-5 
data set control block (DSCB) indicating that no tracks are 
available for allocation. 
When initializing a 3330 as a Mass Storage System staging 
pack, cylinders 0 through 408 are identified as primary 
cylinders, and cylinders 409 and 410 are identified as 
alternate cylinders. 


When initializing a 3330-11 as a Mass Storage System © 
staging pack, cylinders 0 through 808 are identified as 
primary cylinders, and cylinders 803 through 814 are 
identified as alternate cylinders. 


EMUCn) 
Indicates that a partial CKD disk emulated ona fixed block 
device is to be initialized. In a stand-alone environment, 
you must also specify the DEVICETYPE parameter. 


EMUALL 
Indicates that a full CKD disk emulated on a fixed block 
device is to be initialized. | 


Abbreviations: None. 

Defaults: None. 

Restrictions: A volume being initialized as a Mass Storage 
System staging pack must be initialized offline at the medial or 


maximal level. 


The MINICn) parameter is valid in a stand-alone environment 
only, and requires the DEVICETYPE parameter to be specified. 


When the MIMICCMSS) parameter is specified, the VTOC, LABELS, 
and IPLDD parameters do not apply and are ignored. 


The only device types that are valid with the MIMICCMSS) 
parameter are: 3330 and 3330-11. 


58 Device Support Facilities User's Guide and Reference 


INIT 


An emulated 3330 on a fixed block device has Limited function, 
and only minimal initialization is possible on this device; 
hence parameters such as CHECK(n), VALIDATE, and RECLAIM do not 
apply. 


When you initialize a fixed block architecture (FBA) minidisk, 
do not specify the MIMIC parameter. 


MAPINOMAP: PRINTING A VOLUME MAP 


Explanation: MAPI|NOMAP are optional parameters specifying 
whether to print a volume map during initialization. The volume 

| map lists blocks and/or tracks that are found to be defective 
during initialization. 


MAP 
Indicates that you want to print a volume map during 
Initialization. 
For fixed block architecture devices, MAP specifies that a 
block map should be printed. The format of this map is the 


same as that printed by the MAPALT command when DETAIL is 
specified. 


| Indicates that you do not want to print a volume map or 
block map durtng tnitialization. 
Abbreviations: None. 
Defaults: The default is MAP. 


Restrictions: None. 


EXAMPLES OF WAYS TO CODE THE INIT COMMAND 


The following examples show different ways to code the INIT 
command. Most are for the offline and online modes of OS/VS. To 
initialize a volume in a stand-alone environment, do the 
following: 


e Eliminate the OS/VS JCL. 


® Substitute the UNITADDRESS parameter for the DDNAME 
parameter. 


e Specify the DEVICETYPE parameter. 


e Substitute SYSIN for dname if the IPLDD parameter is 
specified. 


To initialize a volume in the DOS/VSE environment, do the 
following: 


® Replace the OS/VS JCL statements with DOS/VSE system control 
statements. 


° Substitute the SYSNAME parameter for the DDNAME parameter. 

® Substitute dlblname for dname if the IPLDD parameter is 
specified and the data set is located on a direct access 
volume. If the data set is included in stream, replace the 
dname with either SYSIN or SYSIPT. 


e Introduce the DOSVTOC parameter if a DOS type VTOC is 
required on the volume. 
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INITIALIZING A 


INITIALIZING A 


Note: Any values specified here are examples only and should not 
be interpreted as the values for your system. 


VOLUME FOR THE FIRST TIME IN OFFLINE MODE C(OS/7VS): EXAMPLE 1 


In this example, a volume is initialized at the minimal level 
because neither the CHECK nor VALIDATE parameter is specified. 
Because the volume is being initialized for the first time, it 
must be mounted offline, and the volume serial number must be 
specified. Because the VTOC parameter is not specified, the 
program supplies a default volume table of contents at cylinder 
0, track 1 that occupies one track. Initialization itn offline 
mode causes any existing data to be purged, regardless of 
whether it is unexpired or password protected. 


/7EXAMPLE1 JOB 
// EXEC PGM=ICKDSF 
//SYSPRINT DD SYSOUT=A 
“/SYSIN DD x 
INIT UNITADDRESS(353) NOVERIFY VOLIDC(VOL123) - 
OWNERIDCPAYROLL) 
1% 


VOLUME AT THE MINIMAL LEVEL IN ONLINE MODE (OS/VS): EXAMPLE 2 


In this example, a volume is reinitialized at the minimal level 
because neither the CHECK nor VALIDATE parameter is specified. 
Because the VOLID and OWNERID parameters are not specified, the 
volume serial number and owner identification that exist on the 
volume remain unchanged on the reinitialized volume. Because the 
VTOC parameter is not specified, the program creates a default 
volume table of contents at cylinder 0, track 1 that occupies 
one track. By accepting the default parameter NOPURGE, the 
command terminates if unexpired or password-protected data sets 
are found. 


S/EXAMPLE2? JOB 
7 EXEC PGM=ICKDSF 
S7XYZ987 DD UNIT=3330,DISP=OLD,VOL=SER=PAY456 
//SYSPRINT DD SYSOUT=A 
7/SYSIN DD x 
INIT DDNAMECXYZ987) NOVERIFY 
7X 


INITIALIZING A VOLUNE AT THE MEDIAL LEVEL IN A STAND-ALONE ENVIRONMENT: 


EXAMPLE 3 


In this example, a previously initialized volume is 
reinitialized at the medial level because the VALIDATE parameter 
1S specified and the CHECK parameter is not. The home address 
and record 0 on each track are read and validated. The volume 
serial number and owner identification are verified before 
Initialization continues and, because a new volume serial number 
or an owner identification 1s not specified, they remain 
unchanged on the reinitialized volume. Specification of the VTOC 
parameter causes a volume table of contents to be created at 
cylinder 42, track 12, that occupies three tracks. Because the 
volume is being reinitialized in a stand-alone environment, all 
existing data is purged, regardless of whether it is unexpired 
or password protected. 


INIT UNITADDRESS(272) - 
VERIFYCVOL123 PAYROLL) VALIDATE VTOC(C42,X'C',3) 
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INITIALIZING A VOLUME AT THE MAXIMAL LEVEL IN A STAND-ALONE ENVIRONMENT: 


EXAMPLE 4 


In this example, a volume is initialized at the maximal level 
because the CHECK parameter is specified. If the results of 
surface checking show tracks are nondefective but were 
previously marked defective, the tracks are reclaimed. The 
volume serial number and owner identification remain unchanged. 
The volume table of contents begin at cylinder 2, track 9 and 
occupy one track. Because the IPLDD parameter is specified and 
the IPL program data is supplied Cindicated by the vertical 
ellipsis in the example), the IPL bootstrap records will be 
supplied by the program by default. Because the volume is being 
reinitialized in a stand-alone environment, all existing data is 
purged, regardless of whether it is unexpired or password 
protected. 


INIT UNITADDRESS(350) CHECK(2) RECLAIM - 
NOVERIFY IPLDDCSYSIN) VTOCC2,0,1) 


® 
@ 
@ 


INITIALIZING TWO VOLUMES IN OFFLINE MODE (0OS/VS): EXAMPLE 5 


In this example, the VALIDATE parameter without the CHECK 
parameter in the first INIT command causes medial level 
initialization. The volume serial number is verified before 
initialization continues and is then replaced by the one 
supplied in the command. A default volume table of contents 
begins at cylinder 0, track i and occupies one track. Four user 
volume labels are written in addition to the volume label. 
Because the volume is being reinitialized in offline mode, all 
existing data is purged, regardless of whether it is unexpired 
or password protected. The IPLDD parameter specifies that a 
user~supplied IPL program is to be written, and the BOOTSTRAP 
parameter specifies that the bootstrap records are also 
user-~supplied. (The IPL program and bootstrap records are 
indicated by the vertical ellipsis.) There are four user volume 
labels to be written on the volume. 


The second INIT command initializes a volume at the minimal 
level. The volume serial number and owner identification remain 
unchanged. A default volume table of contents 15 written at 
cylinder 0, track 1 and occupies one track. Because the volume 
is being reinitialized in offline mode, all existing data is 
purged, regardless of whether it is unexpired or password 
protected. 


/7EXAMPLES5 JOB 
// EXEC PGM=ICKDSF 
/7IPLDECK DD x 


@ 
@ 
¢ 


L¥ 
//SYSPRINT DBD SYSOUT=A 
“/73SYSIS DD as 


INIT UNITADDRESS(353) VALIDATE VOLIDCAAA789) - 
OWNERIDCSMITH) VERIFYCXYZ1i23) - 
IPLDDCIPLDECK) BOOTSTRAP LABELSC4) NOMAP 

INIT UNITADDRESSC271) NOVERIFY 

“*® 
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INITIALIZING A VOLUME AT THE MEDIAL LEVEL IN OFFLINE MODE (OS/VS) AS A MASS 
STORAGE SYSTEM STAGING PACK: EXAMPLE 6 © 


In this example, the VALIDATE parameter without the CHECK 
parameter causes medial level initialization. The volume serial 
number and owner identification are not changed. A default 7 
volume table of contents begins at cylinder 0, track 2 and 
occupies one track. Because the volume is being reinitialized in 
offline mode, all existing data is purged, regardless of whether 
it is unexpired or password protected. 


//EXAMPLE6 JOB 
1/ EXEC PGM=ICKDSF. 
//SYSPRINT DD SYSOUT=A 
“/3SYSIN DD x 
INIT UNITADDRESS(253) NOVERIFY VALIDATE - 
MIMICCMSS) 
7% 


INITIALIZING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 7 


In this example, a mini 2314 1s initialized without an IPL 
program. It provides 19 primary cylinders and one alternate 
cylinder on unit 150. The VTOC is located on cylinder 1, track 
1, and is one track long labeled 231401. The surface 1s checked 
and, if any tracks are found to be defective, alternate tracks 
are assigned. The label and VTOC are written in OS format. 


INIT UNITADDRESS(C150) NOVERIFY DEVICETYPE(2314) - 
MIMICCMINIC20)) VTOCC1,1,1) VOLIDC231401) CHECK(5) 


INITIALIZING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 8 


In this example, a mini 3330 is initialized without an IPL 
program. It provides 30 primary and no alternate cylinders on 
unit 151. The VTOC is written on a dafault location of cylinder 
0, track 1 for a length of one track. The volume is labeled 
333000. The IPL program supplied as the input deck is written on 
rial 0, track 0. The label and VTOC are written in OS 

ormat. | 


INIT UNITADDRESS(151) NOVERIFY DEVICETYPE(3330) - 
MIMICCMINIC30)) VOLIDC333000) IPLDDCSYSIN) 
INITIALIZING A VOLUME AT MININAL LEVEL IN THE DOS/VSE ENVIRONMENT: EXAMPLE 9 
In this example, a volume is initialized at a minimal level 


under DOS/VSE. A DOS/YVSE format VTOC is written on cylinder 32, 
track 0 for a length of 20 tracks. The volume is labeled 231401. 


‘7 JOB jobname 
/?7  &SSGN SY$S002,151 
| // EXEC ICKDSF,SIZE=AUTO 


INIT SYSNAMECSYS002) NOVERIFY - 


DOSVTOC(X'20',X'0",X'14") VOLID( 231401) 
7% | 
/ & 
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INITIALIZING AN EMULATED PARTIAL DISK AT MINIMAL LEVEL IN THE DOS/VSE 


ENVIRONMENT > 


EXAMPLE 10 


In this example, an emulated partial disk is initialized under 
DOS/VSE. A DOS/VSE format VTOC is written at cylinder 0, track 1 
for a length of 1 track. The volume is labeled AA2311. 


// JOB jobname 
//  ASSGN SY¥S000,353 
4/7 EXEC ICKDSF,SIZE=AUTO 


INIT SYSNAMECSYS000) NVFY DVTOCCO0,1,1) - 
VOLIDCAA2311) MIMICCEMUC20)) 
7% , 
/& 


INITIALIZING A VOLUME WITH AN INDEX (OS/VS): EXAMPLE 11 


INITIALIZING A 
EXAHPLE le 


INITIALIZING A 
EXAMPLE 13 


This example is similar to Example 2, above, but as a result of 
this command an index to the VTOC is created. 


7 JOB 
// EXEC PGM=ICKDSF 
SARYZ987 DD UNIT=3375,DISP=OLD,VOL=SER=PAY456 
//7SYSPRINT DD SYSOUT=A 
“/3YSIN DD x 

INIT DDNAMECXYZ987) NOVERIFY INDEXCX'A',X'*B!,X'2') 
7X 


FIXED BLOCK ARCHITECTURE VOLUME IN A STAND~ALONE ENVIRONMENT: 


In this example, a Fixed Block Architecture device 1s 
initialized at a minimal level. The volume is labeled 331022. 
The owner ID of SMITH is written in the volume label. Space is 
reserved for 3 additional user volume labels starting at block 
1, and a fixed block architecture VTOC starting at block 2 for 
100 blocks with a VTOC control interval size of 512. NOMAP 
suppresses the list of alternates. 


‘INIT UNITADDRESS(2E4) NOVERIFY NOCHECK VOLID(331022) - 
OWNERIDOSMITH) LABELSC3) FBAVTOC(2,100,512) NOMAP 


FIXED BLOCK ARCHITECTURE VOLUME IN A DOS/VSE ENVIRONMENT: 


In this example, a fixed block architecture device is 
initialized at a maximal level by specifying CHECK and VERIFY. 
The volume serial and owner ID are verified before 
initialization 1s continued. Surfaces are checked and, if any 
blocks are found to be defective, alternate blocks are assigned. 
An FBA VTOC is located starting at block 2 for 100 blocks with a 
VTOC control interval size of 102%. MAP specifies a detail map 
16 to be printed. Any blocks that were previously flagged 
defective but now appear to be usable after surface checking are 
reclaimed. 


// JOB jobname 
//  ASSGN S790055553. 
// EXEC ICKDSF,SIZE=AUTO 


INIT SYSNAMECSYS005) VERIFY(337011,JONES) CHECK(1) - 
FBAVTOC(2,100,1024) MAP RECLAIM 
/¥ 
/% 
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INIT 


iar ae A FIXED BLOCK ARCHITECTURE MINIDISK IN A STAND-ALONE ENVIRONMENT: 
EXANPLE | 


In this example, a fixed block architecture 3370 minidisk is 
initialized in a stand-alone environment. The volume ID and 
owner ID are checked. Space is reserved for a fixed block 
architecture VTOC starting at block 2, for 1830 blocks with a 
VTOC control interval size of 512. The volume is labeled 337019. 
Space is reserved for 3 user volume labels. The size of the 
minidisk is obtained from VM/7370. : 


‘ INIT UNITADDRESS(151) VERIFY(337022,PSMITH) - 
FBAVTOC(CX?2',X'64',X'200') VOLIDC337019) LABELS(3) 
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| INSPECT: INSPECTING A VOLUME FOR DEFECTIVE BLOCKS OR TRACKS 


| 


After initialization, you can use the INSPECT command to inspect 

| an apparently defective volume to detect dafective blocks or 
tracks and to assign alternate blocks or tracks, or to reclaim 
tracks that were previously flagged defective. Several options 
are available for inspection: 


The TRACKS and ALLTRACKS parameters are provided to inspect 
individual tracks or all the tracks. 


For fixed block architecture CFBA) volumes, the BLOCKS 
parameter is provided to inspect blocks. 


The CHECK parameter is provided to check each block or track 
surface and to permit optional specification of the number 
of checking cycles that are to be performed on each block or 
track being inspected. Normally, an alternate is assigned to 
a primary block or track only after an inspection of the 
surface reveals defects. The NOCHECK parameter suppresses 
such checking and, unless alternate block or track 
assignment is suppressed, an alternate will be 
unconditionally assigned to a defective block or track. 


The PRESERVE parameter is provided to save data that would 
normally be destroyed during block or track inspection. 
Before a surface 15 inspected, its contents are read and 
saved. After a surface 1s inspected and found to be 
nondefective, the saved data contents are written back to 
the same area. If a block or track is found to be defective, 
the saved data contents are written on an assigned 
alternate. The NOPRESERVE parameter allows inspection to 
destroy the data content of a block or track. 


The RECLAIM parameter is provided to reclaim a track that 
was previously flagged defective, but track inspection has 
determined is capable of recording data. The NORECLAIM 
parameter suppresses automatic track reclamation. These 
parameters are invalid for fixed block architecture CFBA) 
devices. 


The ASSIGN parameter automatically assigns alternates for 
primary or alternate blocks or tracks that are found to be 
defactive. Automatic assignment of alternates is suppressed 
by the NOASSIGN parameter. 


The MAP parameter provides printed output of the detailed 
status of each block or track. The NOMAP parameter 
suppresses the printed output. 


For 3375 and 3380, when a CHECK function is being performed, 
ICKDSF performs surface checking to locate and/or skip over 
dafective areas on the track. If the primary track contains 
more than the maximum number of allowable defects, an 
alternate track 1s assigned, if specified. 


INSPECTING A VOLUME TO ASSIGN ALTERNATE BLOCKS OR TRACKS 


| A block or track can be flagged as defective, and an alternate 
assigned, either conditionally or unconditionally. You can 
| control the assignment of alternate blocks or tracks as follows: 


® 


Issue the INSPECT command and specify the CHECK and ASSIGN 
parameters to detect defective primary and alternate blocks 
or tracks. If a primary or alternate surface is identified 
as defective by surface checking, the surface is flagged as 
defective, and an alternate surface is assigned to the 
defective block or track. 
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® For the 3375 and 3380, issue the INSPECT command and specify 
CHECK to initiate surface checking for defects. An alternate 
track 1s assigned only if more than the maximum allowable 
number of defects are detected. 


° Issue the INSPECT command and specify the NOCHECK and ASSIGN 
parameters to unconditionally assign alternate surfaces for 
the blocks or tracks inspected. 


e To inspect primary and alternate blocks or tracks, but to 
prevent assignment of alternates, issue the INSPECT command 
and specify the NOASSIGN parameter. Note that if PRESERVE is 
specified and user data cannot be rewritten because of 
surface defects, an alternate is assigned. 


INSPECTING A VOLUME TO RECLAIM TRACKS 


SYNTAX 


As alternate tracks are assigned, either unconditionally or 
conditionally, their number decreases. A volume can reach a 
point at which the volume becomes unusable because of the 
reduced number of altarnate tracks available. 


Both primary and alternate tracks can be reclaimed. Because the 
surface checking performed by Device Support Facilities is not 
as exacting as that performed by the manufacturer using special 
hardware analyzers, factory-flagged tracks may be reclaimed and 
later use of the track can show previously undetected defects. 
You control track reclamation by using RECLAIM or NORECLAIM 
together with CHECK in the INSPECT command. 


For the 3375 and 3380, specifying RECLAIM with TRACKS causes 
ICKDSF to attempt to recover defective tracks by skipping over 
defective areas. If more than the maximum number of allowable 
defects are detected, an alternate track is assigned if 
spacified. Note that the surface checking information mentioned 
above, which is collected by the manufacturer, is not reset by 
ICKDSF processing. 


The abbreviation for the INSPECT command is INSP. 


Required Parameters 


INSPECT UNITADDRESS(cuu) | 
DDNAMECdname) | 
SYSNAMEC sysxxx) 
TRACKS (Ccylinder,track)[,...])] 
ALLTRACKS 
BLOCKS(rbnLl,...J]) 
VERIFYC serial t ounerde 
NOVERIFY 


Optional Parameters 


DEVICETYPE(devtype) 
CHECK (n) | NOCHECK 
RECLAIM|NORECLAIM 
PRESERVE | NOPRESERVE 
MAP [NOMAP 

ASSIGN |NOASSIGN 
NIMICCdavtype) 
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UNITADDRESS |DDNAME|SYSNAME: IDENTIFYING THE DEVICE WHERE THE VOLUME IS MOUNTED 


Explanation: UNITADDRESS(cuu) |[DDNAME Cddname) |SYSNAME( sysxxx) 
are required parameters identifying the volume that is to be 
inspected. : 


UNITADDRESS 
Required when inspecting a volume that is mounted offline 
o> When inspecting a volume ina stand-alone environment. 


For cuu, specify the address in hexadecimal of the channel 
and unit on which the volume 415s mounted. 


Note: The device must be on a channel that is online. If 
the device is on a channel that is offline, the program 
might enter a nonterminating wait state. 


DDNAME 
Required when inspecting a volume that is mounted online. 
The device on which the volume is mounted must be online 
and the volume mounted as PRIVATE with DISP=OLD specified. 


For dname, specify the OS/VS JCL DD statement that 
identifies the device on which the volume is mounted. 


SYSNAME 
Required when inspecting a volume in the DOS/VSE 
environment. For syvsxxx, specify the SYSNAME specified in 
the ASSGN system control statement. 


Abbreviations: 


UNITADDRESS|UNIT 
DDNAME| DNAME 


Defaults: None. 


Restrictions: The UNITADDRESS parameter cannot be specified 
when inspecting a volume that 15 mounted online. 


The DDNAME parameter cannot be specified when inspecting a 
volume that is mounted offline or ina stand-alone environment 
or the DOS/VSE environment. 


The SYSNAME parameter cannot be specified when inspecting a 
volume in the stand-alone or OS/VS environment. 


TRACKS TALLTRACKS: SPECIFYING WHICH TRACKS TO INSPECT 


Explanation: TRACKS(cylinder,track)|ALLTRACKS are required 
parameters specifying the tracks to be inspected. 


TRACKS | 
Required when inspecting individual tracks on the volume. 


For cylinder,track, specify one to four decimal (n) or 
hexadecimal ¢(X'n') numbers to identify the cylinder, and 
one to four decimal (€n) or hexadecimal (X'n') numbers to 
identify the track to be inspected. 


ALLTRACKS 
Required when inspecting all the tracks on the volume. 


| ALLTRACKS is not valid with NOPRESERVE. 


Note that the use of this option in conjunction with the 
CHECK(n) parameter can be time-consuming. 
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Abbreviations: 


TRACKS |] TRACKITRKS|TRK 
ALLTRACKS | ALLTRACK]ALLTRKS|ALLTRK 


Defaults: None. 


Restrictions: The maximum number of individual tracks that can 
ba specified with the TRACKS parameter is 20. 


| This parameter is invalid for fixed block architecture devices. 


| BLOCKS: SPECIFYING WHICH BLOCKS TO INSPECT 


Explanation: BLOCKS(rbnl,...]) is a required parameter 
specifying the blocks to be inspected. 


For rbn, substitute the relative block number of the block to be 
inspected. Specify one to six decimal (n) or hexadecimal (X'n') 
characters. The number of rbn parameters specified cannot 
axceed 20. 

| abbreviations: 

| BLOCKS | BLOCK 


| Defaults: None. 


ae strictiens: The number of rbn parameters specified cannot 
excead 20. | 


| This parameter is valid for fixed block architecture devices 
only. 


VERIFY |NOVERIFY: 


Explanation: VERIFY(seriall,ownerJ])]NOVERIFY are required 
parameters specifying whether to verify the volume serial number 
and owner identification before inspecting the volume. 


VERIFY 
Peaurred when you want to verify the volume serial number 
and owner identification before inspecting the volume. If 
the volume serial number or owner identification does not 
match that found on the volume, the INSPECT command 
tarminates. , 


For serial, substitute one to six alphameric characters for 
the volume serial number. 


For owner, substitute one to fourteen ppRaell stb characters 
for the owner identification. 


NOVERIFY 
Required when you want to bypass verification of the volume 
serial number and owner identification. 


Abbreviations: 


VERIFY|VFY _ 
NOVERIFY|NOVFY|NVFY 


Defaults: None. 
Restrictions: You cannot verify the owner identification 
separately from the volume serial number. Both the volume serial 


number and owner identification must be verified when you want 
to verify the owner identification. 
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When you specify the VERIFY parameter and verification fails, 
execution of the command terminates. 


DEVICETYPE: IDENTIFYING THE TYPE OF DEVICE 


Explanation: DEVICETYPE(devtype) is required in a stand-alone 
environment when the MIMICCMINI) or MIMICCEMU) parameter is 
specified. 


For devtype, substitute one to eight characters for the type of 
device on which the volume is mounted. See Figure 2 on page ¢ 
for valid device types. 


Abbreviations: 
DEVICETYPE|DEVTYPE|DEVTYP 
Defaults: None. 


Restrictions: The DEVICETYPE parameter applies only when you 
are inspecting a volume in a stand-alone environment and 
MIMICCMINID or MIMICCEMU) is specified. If DEVICETYPE is 
specified when it does not apply, it will be ignored. 


When using a 3350 Direct Access Storage volume in 
3330-compatibility mode, the device type must be specified as 
3330 or 3330-11, as required. The 3333 Disk Storage and Control 
Models 1 and 11 must be specified as 3330 and 3330-11, 
respectively. 


| This parameter is valid only for count key data devices. 


CHECKINOCHECK!: SURFACE CHECKING OF THE VOLUME 


Explanation: For count key data devices, CHECK(n)|NOCHECK are 
optional parameters specifying whether the tracks are to be 
checked for recording errors. Each track is surface checked by 
writing and reading specially patterned records. Upon 
satisfactory completion of surface checking, each checked track 
15 rewritten with a standard record 0. If surface checking 
identifies a defective primary track, the track is flagged, and 
an available alternate track 1s assigned to it. If an alternate 
track is identified as defective, it 15 flaggad and treated as 
unavailable and, if it i585 associated with a primary track, the 
primary track is assigned a different alternate track. 


For fixed block architecture (CFBA) volumes, CHECK(n) |NOCHECK are 
optional parameters specifying whether the blocks are te be 
checked for recording errors. Each block is surface checked by 
Writing and reading specially patterned records. If surface 
checking identifies a defective block, the block is flagged, and 
an available alternate block 15 assigned. | 


CHECK 
| Indicates that you want each block or track to be surface 
checked for recording errors during inspection and assigned 
| an alternate only if the checked block or track appears 
defective. 


For n, substitute a decimal number from 1 through 255 for 
the number of times you want each block or track to be 
checked. See "Appendix G. Surface Analysis” for information 
on n values. 


For the 3375 and 3388, if you specify this parameter and 
TRACKS, ICKDSF automatically tries to recover from defects 
on the track by skipping over the dafective areas. If this 
fails, and ASSIGN is specified, an alternate track i5 
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RECLAIMINORECLAIM: 


assigned. If you specify CHECK and ALLTRACKS, ICKDSF tries 
to recover from defects on the track by skipping over the 
defective areas when primary analysis indicates the 
possibility of a repeatable data check. If this fails, and 
ASSIGN is specified an alternate track is assigned. Note 
that the use of CHECK with TRACKS can be time consuming. 
See "Appendix G. Surface Analysis" for more information. 


NOCHECK | | 
Indicates that you do not want each block or track to be 
surface checked for recording errors during inspection. 
Alternate blocks or tracks are unconditionally assigned as 
a result of inspection when NOCHECK and ASSIGN are 
spacified. 


Abbreviations: 


CHECK|C 
OCHECK NOGHRINGHE 


Defaults: The default is CHECK(1). 


Restrictions: The maximum number of times you can specify with 
the CHECK parameter is 255. However, if the ALLTRACKS parameter 
is specified, the maximum number of times you can spacify is 10; 
if a number larger than 10 is specified, the number defaults to 
0, 


FLAGGED DEFECTIVE 


Explanation: RECLAIM|NORECLAIM are optional parameters 
specifying whether to reclaim tracks that were previously 
flagged defective but appear to be usable after surface 
checking. 


Because surface Shesiids is not as exacting as that performed by 


the manufacturer using special hardware analyzers, later use of 


the track can show previously undetected defects. 


RECLAIM | | 
Indicates that you want tracks that are identified as 
usable by surface checking to be reclaimed during 
inspection. 


~NORECLAIM 


Indicates that you want to suppress track reclamation 
during inspection. 


Abbreviations: 
RECLAIMIRCLM 
NORECLAIM| NORCLMINRCLM 
Defaults: The default is NORECLAIM. 


Restrictions: The RECLAIM parameter applies only when the CHECK 
parameter has been specified. If RECLAIM is specified with 
NOCHECK, it is ignored. 


You Set reclaim tracks on 2305 Fixed Head Storage Models 1 
and 


| This parameter is invalid for fixed block architecture devices. 


70 Device Support Facilities User's Guide and Reference 


INSPECT 


PRESERVE|NOPRESERVE: PREVENTING DESTRUCTION OF DATA ON THE BLOCKS OR TRACKS 


LHSPECTED 


Explanation: PRESERVEINOPRESERVE are optional parameters 

| specifying whether to save the data on the inspected blocks or 
tracks. If an inspected primary block or track ia identified as 
defective, the data 15 rewritten on the alternate that is 
assigned. If an alternate block or track that is associated with 

| a primary surface is identified as defective, the alternate is 
flagged as defective, and the data is rewritten to an available 
alternate. If a primary track that was previously flagged as 
defective is reclaimed, the data is copied from the alternate 
surface to the reclaimed primary surface, and the alternate 
surface 15 made available. 


If PRESERVE NOASSIGN is specified, but user data cannot be 
rewritten after it has been read, ICKDSF overrides the NOASSIGN, 

| assigns an alternate block or track, and rewrites the data on 
the alternate. 


PRESERVE 
Indicates that you want to save the data on the inspected 
| blocks or tracks. 


NOPRESERVE 
Indicates that you do not want to save the data on the 
| inspected blocks or tracks. 


NOPRESERVE is not valid with ALLTRACKS. 
Abbreviations: 


PRESERVE|PRSV 
NOPRESERVE|NOPRSVINPRSV 


Defaults: The default is PRESERVE. 


Restrictions: Note that the data area of a rewritten record 0. 
is set to eight bytes of binary zeros. 


Caution: If you specify the NOPRESERVE parameter with either 
the CHECK or ASSIGN parameter, data on the volume will be 
destroyed. 


Note that the VTOC 1s no exception to this rule. Special care 
must be taken with the volume serial in an online environment. 


Explanation: MAP|INCMAP are optional parameters specifying 
whether to print a volume map during inspection. The volume map 

| lists blocks or tracks that are found to be defective during 
Inspection. 


the format of the printed map is the same as that printed by the 


| For fixed block architecture (CFBA) volumes, if you specify MAP, 
MAPALT command when DETAIL is specified. 


MAP 
| Indicates that you want to print a block or volume map 
during inspection. 


NONAP 
| Indicates that you do not want to print a block or 
volume map during inspection. 


Abbreviations: None. 
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Defaults: The defauit is MAP. 


Restrictions None. 


SPECIFYING ASSIGNMENT OF ALTERNATE BLOCKS CR TRACKS 


Explanation: ASSIGNINOASSIGN are optional parameters specifying 
whether alternates are to be assigned when defective primary and 
| assigned alternate blocks or tracks are detected. 


ASSIGN 
Indicates that you want alternates to be assigned when 
| defective primary and assigned alternate blocks or tracks 
are detected. 


NOASSIGN 
| Indicates that you do not want alternate blocks or tracks 
assigned. If PRESERVE is specified and user data cannot be 
rewritten because of surface defects, an alternate is 
assigned. 


Abbreviations: 


ASSIGNIASGN 
NOASSIGN|NOASGNINASGN 


Defaults: The default is ASSIGN. 
Restrictions: If NOASSIGN is specified with the CHECK 


parameter, an inspected block or track is not marked defective 
and an alternate 15 not assigned. 


MIMIC: SPECIFYING A A SPECTAL VOLUME USAGE FORMAT 


Explanation: MINIC(devtype) is an optional parameter specifying 
a special usage format for the volume being inspected. You may 
specify MINICn), MSS, EMUCn), or EMUALL. 


MINT On) | 
Indicates that the volume to be inspected is a minidisk of 
™"n' cylinders. This disk must have been previously 
initialized. The DEVICETYPE parameter is required when this 
parameter is specified. 


Note that this parameter is valid tn the stand-alone 
environment only. See Appendix B for details of this 
support. 


Indicates that the volume has been formatted as a Mass 
Storage System staging pack. This parameter is raquired 
when inspecting an MSS staging pack. 


EMUCN) 
Indicates that a partial CKD disk emulated on a fixed block 
device is to be inspected. The DEVICETYPE parameter is 
required when this parameter 1s specified in the 
stand-alone environment. , 


EMUALL | 
Indicates that a full CKD disk is emulated on a fixed block 
device. 

Abbreviations: None. 


Defaults: None. 
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Restrictions: The only device types valid for MINI(n) are 2311, 
2314, and 2319. Inspection of an emulated 3330 CEMUCn) |] EMUALL) 
is not permitted. 


| This parameter is invalid for fixed block architecture devices. 


EXAMPLES OF HAYS TO CODE THE INSPECT COMMAND 


The following examples show different ways to code the INSPECT 
command. Most illustrate the use of the command in offline and 
online mode under OS/VS. To inspect a volume ina stand-alone 

environment, make the following changes to OS/VS examples: 


® Eliminate the OS/VS JCL. 


e Substitute the UNITADDRESS parameter for the DDNAME 
parameter. 


° Specify the DEVICETYPE parameter. 
e Substitute SYSIN for dname in the IPLDD parameter. 


To inspect a volume in the DOS/VSE environment, do the 
following: 


e Replace the OS/VS JCL statements with DOS/VSE system control 
statements. 


° Substitute the SYSNAME parameter for the DDNAME parameter. 


e Substitute dlblname for dname if the IPLDD parameter 15 
specified and the data set is located on a direct access 
volume. If the data set is included in the job stream, 
replace the dname with either SYSIN or SYSIPT. 


° Introduce the DOS VTOC parameter if a DOS-type VTOC is 
required on the volume. 


Note: Any values specified here are examples only and should not 
be interpreted as the values for your system. 


INSPECTING A VOLUHE FOR CONDITIONAL ASSIGNHENT OF ALTERNATE TRACKS IN ONLINE 


MODE €OS/VS): 


EXAMPLE 1 


In this example, the assignment of alternate tracks depends on 
the results of surface checking. The data on each specified 
track 15 copied to an alternate track if the track 1s defective, 
or 185 written back to the primary track if the track is not 
defective. 


//EXAMPLEL JOB 
/f EXEC PGM=ICKDSF 
//NOLUMEG DD UNIT=3330,DISP=OLD,VOL=SER=PAY345 
//SYSPRINT DD SYSOUT=A 
//SYSIN DD x 
INSPECT DDNAMECVOLUMEG) NOVERIFY CHECK(2) - 
TRACKS C01,3),01,2),02,0),02,3),03,2)) 
7% 


INSPECTING A VOLUME FOR UNCONDITIONAL ASSIGNMENT OF ALTERNATE TRACKS IN OFFLINE 


MODE (OS/VS): 


EXAMPLE 2 


In this example, the next available alternate track is assigned 
for the specified primary track. If the primary track is already 
assigned an alternate track, it will be reassigned a different 
alternate track. The default parameter PRESERVE causes the 
contents of the specified primary track to be copied to the 
assigned alternate. 
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/7EXAMPLE2 JOB | : 
ay EXEC PGM=ICKDSF 
/7SYSPRINT DD SYSOUT=A 
//SYSIN DD x 
INSPECT UNITADDRESS(273) NOVERIFY TRACKS(X'2',3) NOCHECK 
7% 


INSPECTING AN ENTIRE VOLUME TO PRODUCE A VOLUME MAP IN A STAND-ALONE 
ENVIRONMENT: EXAMPLE 3 


In this example, all the tracks on the volume are inspected to 
produce a volume" map that lists all the defective tracks. No 
alternate tracks are assigned. 


INSPECT UNITADDRESS(353) NOVERIFY - 
ALLTRACKS NOASSIGN 


INSPECTING A VOLUME TO RECLAIM TRACKS IN OFFLINE MODE (OS/VS): EXAMPLE 4 


In this example, a volume is tnspected to reclaim tracks that 
were previously marked defective. The default parameter PRESERVE 
causes the contents of the alternate track to be copied to the 
primary track if the primary track is raclaimed. Then, the 
alternate track becomes available for future assignment. 


//EXAMPLE4 JOB 
47 EXEC .PGM=ICKDSF 
//7SYSPRINT DD SYSOUT=A 
//SYSIN DD 4s 
INSPECT UNITADDRESS(€354) NOVERIFY TRACKS((€2,3) (3,1) €1,3)) - 
RECLAIM 
7% 


INSPECTING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 5 


In this example, a mini 2314 that has already been initialized 
is inspected. It provides an unconditional assigment of an 
alternate track for tracks 5,1 and 5,2. Note that the parameter 
MIMICCMINI(20)) is specifying to Device Support Facilities that 
a minidisk is being inspected. If this parameter were not 
specified, the whole volume Would be inspected and the alternate 
track would be assigned in the alternate track area of a full 
volume. 


INSPECT UNITADDRESS(150) NOVERIFY TRACKS((5,1),05,2)) - 
DEVICETYPEC2314) MIMICCMINIC20)) NOCHECK 


INSPECTING A MINIDISK IN A STAND-ALONE ENVIRONMENT: EXAMPLE 6 


In this example, a mini 2314 that has already been initialized 
is inspected for defective tracks. It provides a surface 
analysis of the entire mini 2314 and a conditional assignment of 
alternate tracks for any tracks that are found defective. If any 
tracks that were flagged defective are found to be acceptable 
after the surface check, these tracks are reclaimed. The data is 
preserved on the volume. 


INSPECT UNITADDRESS(150)2 NOVERIFY ALLTRACKS ~- 


DEVICETYPEC2314) MIMICCMINI(C20)) CHECK(C1) - 
RECLAIM 
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INSPECTING A VOLUME TO RECLAIM TRACKS (DOS/VSE): EXAMPLE 7 


In this example, a volume previously initialized under DOS/VSE 
is inspected. Tracks previously flagged defective that are found 
to be acceptable are reclaimed. 


// SOB jobname 

4/7 ASSGN $Y¥$010,151 

// EXEC ICKDSF,SIZE=AUTO 
INSPECT SYSNAMECSYS010) NVFY TRKSC(C2,3) €3,1) €1,3))0 - 
RECLAIM 

/¥ 

/& 


INSPECTING AN EMULATED PARTIAL DISK (DOS/VSE): EXAMPLE 8 


In this example, all tracks of an emulated partial disk are 
Inspected. Tracks previously flagged defective that are found, 
after the surface check, to be acceptable are reclaimed. 


// JOB jobname 
// ASSGN SYS020,353 
4/f- ~EXEC ICKDSF,SIZE=AUTO 


INSPECT SYSNAMECSYS020) NVFY ALLTRKS — 
RECLAIM MIMICCEMUC20)) 


INSPECTING A FIXED BLOCK ARCHITECTURE DEVICE IN A STAND-ALONE ENVIRONMENT: 
EXAMPLE 9 


In this example, a fixed block architecture device that has 
already been initialized is inspected for defective blocks. It 
provides a surface analysis of the blocks specified in the 
BLOCKS parameter and a conditional assignment of alternate 
blocks for any blocks that are found defective. The data on the 
inspected blocks is preserved. A detail map of the inspected 
blocks is printed. 


INSPECT UNITADDRESS(150) BLOCKS(50,55,57,58) CHECK(1) - 
ASSIGN PRESERVE MAP 


UNCONDITIONAL ASSIGNMENT OF ALTERNATE BLOCKS FOR A FIXED BLOCK ARCHITECTURE 
DEVICE IN A STAND-ALONE ENVIRONMENT: EXAMPLE 10 


In this example, an inspection is performed on a fixed block 
architecture device that has already been initialized. The 
blocks specified in the BLOCKS parameter are unconditionally 
assigned the next available alternate blocks. 


INSPECT UNITADDRESS(380) BLOCKSCX'FA',X'1OE’,X'118"°) - 
NOVERIFY NOCHECK ASSIGN | 


ERMA ea A FIXED BLOCK ARCHITECTURE DEVICE IN A STAND-ALONE ENVIRONMENT: 
EXAMPLE 


In this example, a fixed block architecture device that has 
already been initialized is inspected for defective blocks. The 
blocks specified in the BLOCKS parameter are surface checked for 
errors, but an inspected block is not marked defective and an 
alternate 1s not assigned. 


INSPECT UNITADDRESSC2E4) BLOCKS(2000,2020,2021,2022) - 
CHECK NOASSIGN NOMAP 
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MAPALT: MAP ALTERNATE BLOCK ASSIGNMENTS 


Note: The MAPALT command is valid only in the DOS/VSE and 
stand-alone environments. 


The MAPALT command, for exclusive use on fixed block 
architecture (FBA) direct access storage devices, produces a 
printed report, or map, of the primary blocks that have been 
assigned to alternate blocks on the device. MAPALT parameters 
allow you to specify a limited range of primary blocks to be 
mapped or to specify that the entire volume be mapped. 


Execution of the MAPALT command is restricted to reading the 
identification fields of the primary blocks only. It is not 
necessary to create backup copies of the data on the volume 
before the command is invoked. Thus, the command may be executed 
against either a newly installed Beures or a device that already 
contains user data. | 


The MAPALT command can only be executed against the device 
address that defines the entire device in fixed block mode. 
Emulated devices on fixed block devices are not supported. 


¥VM7370 users will be able to IPL the stand-alone version of 
Device Support Facilities to execute the MAPALT command against 
attached volumes. Users who IPL a DOS/VSE system under VM/370 
can execute the command against attached volumes by submitting 
batch jobs to their virtual machines. 


MAPALT REPORT OUTPUT 


A two-part report is produced. The first part, which may 
optionally be selected, is as shown below: 


PRIMARY BLOCK | ALTERNATE 
BLOCK ADDRESS ADDRESS 
NUDBER 


nnnnvann C=nnn H=nn 
nnnnnn C=nnn H=nn 
nnonannn C=nnn H=nnr 
nnnnnan C=nnn H=nn 
nnnnann C=nnn H=nn 


PREM RE 6) 


This is the detailed report that shows the relative block number 
of the defective primary block, its location on the volume 
(cylinder and head number), and the location of the alternate 
block which has been assigned to the primary block (Calso in 
cylinder and head number). 


The second portion of the report, which is always printed, is a 


summary message showing the number of blocks (within the 
specified range) found to have been assigned to alternates. 
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I7O errors that cause interruption of program execution are 
revorted by the program. The following information appears on 
the program output when such errors occur: 


CSW = xxxxxx x*xxXxXxx CCW = xexxexxKxK XKXKXKXK 
SENSE = xxxxxxXxXxX XXXXXXXM KMKKXXMXKKX XKXKXXKKKK 


MKKXKKKKK KKKRKKK KK 


This information should be used, in accordance with installation 
procedures, as an aid in isolating and correcting the cause of 
the problem. 


if a data check 15 encountered, an error meesage 15 printed 
giving the relative block number of the block causing the error, 
and then processing continues with the next sequential block. 


Command 


| 


Required Parameters | 


URITTADDRESSCcuu) | 
SYSNANE Csysxxx) 


MAPALT 


eA 


Optional Parameters | 
LIMITS(lorbn,hirbn) [ALL | 
DETAIL |NODETAIL 


een com mentee eit ot 


=NTIFYING THE DEVICE ON WHICH THE VOLUME IS MOUNTED 


’ 
ECON ALERANET ) SO ae ERRNO, ra OS AIP OA AH TET Seen cemanaionenadtihomnr anna andasaamneitne san ite chaos aaa actentaceiamenad. cane aeeatndi te naamenasemunigaaantamenaas + roa ee id a poem nat Ma 


Explanation: UNITADDRESS(cuu)|SYSNAME(Csysx¥x) are required 
parameters identifying the volume that 15 to be mapped. 


UNITADDRESS 
Required when mapping a volume that 15 mounted offline or 
when mapping a volume ina stand-alone environment. 


For cuu, specify the hexadecimal address of the channel and 
unit on which the volume is mounted. 


Note: The device must be on a channel that is operational. 
If the device 1s on a channel that is not operational, the 
program may enter a nonterminating Wait state. 


SYSNAME | 

Required when mapping a volume in the DOS/YVSE anvironment. 
For sysxx™m, specify the SYSNAME in the ASSGN control 
statement. 

Abbreviations: 


UNITADDRESS|UNITADDRI UNIT 
SYSNAME | SNAME 


Defaults: None. 


Restrictions: The SYSNAME parameter cannot be specified in a 
stand-alone environment. 
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LIMITSIALL: SPECIFYING THE AREA TO BE MAPPED 


Explanation: LIMITSClorbn,hirbn)]ALL are optional parameters 
specifying the area of the disk where alternate block mapping is 
to be performed. 


LIMITS(lorbn,hirbn) 
The value lorbn specifies the relative block number for the 
start of mapping. This value must be lower than, or equal 
to, the value specified by hirbn. lorbn can be expressed as 
one to six decimal (€n) or hexadecimal (X'n') characters. 


The value hirbn specifies the relative block number for the 
end of mapping. This value must be lower than, or equal to, 
the highest relative block number on the device. hirbn can 
be expressed as one to six decimal (n) or hexadecimal 
(X'n')d characters. 


Indicates that the entire volume is to be mapped. 
Abbreviations: 

LIMITS|LIMIT]LIMS|]LIM 
Default: ALL 


Restrictions None. 


DETAILINODETAIL: CONTROLLING THE PROGRAM QUTPUT 


Explanation: DETAIL |NODETAIL is an optional parameter that 
controls the amount of output from the program. 


DETAIL 
Causes printing of the detailed report that lists each 
defective block assigned to an alternate, gives its 
location on the disk, and gives the location of the 
assigned alternate block. 


NODETAIL | | 
Causes printing of the detailed report to be suppressed. 


Abbreviations: 


DETAILIDTL 
NODETAIL|NODTL 


Default: NODETAIL 
Restrictions: This parameter only controls printing of the 
detailed report and does not affect other output from the 


program. The summary message will be printed at all times upon 
termination of the program. | 


EXAMPLES OF WAYS TO CODE THE MAPALT COMMAND 


The following examples illustrate ways you might code the MAPALT 
command in various situations. 
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MAPPING A VOLUME IN THE STAND-ALONE ENVIRONMENT: EXAMPLE 1 


In this example, a full volume scan of a 3310 direct access 
storage volume is performed and a summary report 15 made of the 
total number of blocks found that have alternates assigned. 


MAPALT UNITADDRESS(141) ALL NODETAIL 
Using abbreviations and defaults, you could have specified: 


MAPALT UNITC141) 


MAPPING A VOLUME IN THE STAND-ALONE ENVIRONMENT: EXAMPLE 2 


In this example, the range of blocks from 200,000 to 300,000 on 
a 3370 direct access storage volume is scanned. A detailed 
report 1s made of each block within that range that has an 
alternate assigned, and a summary report is made giving the 
total number of assigned alternates found. 


MAPALT UNITADDRESS(142) LIMITSC200000,300000) DETAIL 
Using abbreviations, you could have specified: 


MAPALT UNITADDR(C142) LIMC200000,300000) DTL 


MAPPING A VOLUME IN THE DOS/VSE ENVIRONMENT: EXAMPLE 3 


In this example, a full volume scan is performed on the fixed 
block architecture device assigned to SYS001. A detailed report 
is made of each block on the volume that has an alternate 
assigned, and a summary report is made giving the total number 
of alternates found. 


// JOB jobnamea 
// ASSGN SYS001,140 
// EXEC ICKDSF,SIZE=256K 
MAPALT SYSNAMECSYSO01) ALL DETAIL 
7% 
/& 
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REFORMAT: REFORMATTING PORTIONS OF A PREVIOUSLY INITIALIZED VOLUME 


SYNTAX 


LR 08 rae 


HOUNTED 


ee eliaaaneen lunaneiaanoe epemendinns iiiaunttoanaoecetniel 


After a volume has been initialized, it can be reformatted to 
change the volume serial number, cwner identification, and, for 
count key data devices, IPL bootstrap and program records. Only 
volumes that have been initialized can be reformatted. 


For fixed block architecture devices, a voluma can be 
reformatted to change the volume serial number and owner 
identification. Only volumes that have been initialized can be 
reformatted. 


Tne abbreviation for the REFORMAT command is RFMT. 


Command | Required Parameters 


9 ORES PDO IRT IO EMILIO SE PE GOERS IEICE: SORES Be ERY PEST GETT ERNIE se a 


[DDNAMEISYSNAME: IDENTIFYING THE DEVICE ON WHICH THE VOLt 


REFORMAT| UNITADDRESS(cuu) | 


DDNANECdname) | 

SYSNANE Csysxxx) 
VERIFY{(seriall,owner))| 

NOVERIFY 


Optional Parameters 


lenges 


PURGE | NOPURGE 

YOLIDCserial) 

QOHSERTDCowner ) 

IPLDDC {dname]dlblname} 
C,O8JFORMAT],ABSFORMAT]) 


eee “aa conden ern NYRR Rents 7 ore 


BOOTSTRAP |NOSOOTSTRAP 


enema nel 


MEL 


Explanation: UNITADDRESS (cuu) | DDNAMECdname) |SYSNAME( sysxxx ) are 
required parameters identifying the volume that is to be 
reformatted. 


DDNAME 


UNTTADDRESS 


Required when reformatting a volume that is mounted offline 
or when reformatting a volume in a stand-alone environment. 


For cuu, specify the address in hexadecimal of the channel 
and unit on which the volume is mounted. | 


Nate: The device must be mounted on a channel that is 
online. If the device 15 on a channel that is offline, the 
program might enter a nonterminating wait state. 


Required when reformatting a volume that is mounted online. 
The device on which the volume 18s mounted must be online 
and the volume mounted as PRIVATE with DISP=OLD specified. 


For dname, speci fy the OSs/VS JCL BD statement that 
identifies the device on which the volume is mounted. 
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SYSNAME 
Required when reformatting a volume in the DOS/VSE 
environment. For sysxxx, specify the SYSNAME specified in 
the ASSGN system control statement. 


Abbreviations: 


UNITADDRESS|UNIT 
DDNAME| DNAME 


Defaults: None. 


Restrictions: The UNITADDRESS parameter cannot be specified 
when reformatting a volume that is mounted online. 


The DDNAME parameter cannot be specified when reformatting a 
volume that is mounted offline or in a stand-alone environment. 


VERIFYINOVERIFY: VERIFYING THE VOLUME SERIAL NUMBER AND OWNER IDENTIFICATION 


Explanation: VERIFY{serial [,owner])|NOVERIFY are required 
parameters specifying whether to verify the volume serial number 
and owner identification before reformatting the volume. 


VERIFY | 
Required when you want to verify the volume serial number 
and owner identification before reformatting the volume. If 
the volume serial number or owner identification does not 
match that found on the volume, the REFORMAT command 
tarminates. 


For serial, substitute one to six alphameric characters for 
the volume serial number. 


For owner, substitute one to fourteen alphameric characters 
for the onner identification. 


NOVERIFY 
Required when you want to bypass verification of the volume 
serial number and owner identification. 


Abbreviations: 


VERIFY|VFY 
NOVERIFY|NOVFY|NVFY 


Defaults: None. 


Restrictions: You cannot verify the owner identification 
separately from the volume serial number; both the volume serial 
number and the owner identification must be verified when you 
want to verify the owner identification. 


When you specify the VERIFY parameter and verification fails, 
exacution of the command terminates. 


Explanation: PURGE|NOPURGE are optional parameters specifying 
whether existing user volume labels are to be written over by 
the specified IPL program, 


PURGE 
Indicates that you want to write over existing user volume 
labels during reformatting. 
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NOPURGE _ | 
Indicates that you do not want to write over any user 
volume labels. If a volume contains user volume labels and 
the IPLDD parameter is specified, the IPL program record is 
written following the last user volume label. 
Abbreviations: 


PURGEIPRG 
NOPURGE|NOPRGINPRG 


Defaults: The default is NOPURGE. 


Restrictions: The PURGE parameter applies only when the IPLDD 
parameter is specified. 


| This parameter is invalid for fixed block architecture devices. 


VOLID: SPECIFYING A NEW VOLUME SERIAL NUMBER 


Explanation: VOLID(serial) is an optional parameter specifying 
a new volume serial number to be written in the volume label. 


For serial, substitute one to six alphameric characters for the 
new volume serial number. If fewer than six characters are 
spacified, the serial number is left-justified and the remainder 
of the field is padded with blanks (X'40'). 

Abbreviations: None. 


Defaults: When you reformat a volume and do not specify the 
VOLID parameter, the old volume serial number remains unchanged. 


Rastrictions: The catalog must be changed to reflect the new 


volume serial number for any cataloged data sets that reside on 
the reformatted volume. 


ONNERID: SPECTFYING A NEW VOLUME-ONNER IDENTIFICATION 


Rare eer maine rece are 


Explanation: ONRNERIDCowner) is an optional parameter specifying 
a new volume-owner identification to be written in the volume 
label. | 


For owner, substitute one to fourteen alphameric characters for. 
a new volume-owner identification in the volume label. 


Abbreviations: 

OWNERIDI OWNER 
Defaults: When a volume is reformatted and a new owner 
identification is not specified, the old owner identification 


remains unchanged. 


Restrictions: None. 
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IPLDD: WRITING A USER-SUPPLIED IPL PROGRAM ON THE VOLUME 


Explanation: IPLDD( {dname|dlblname} [,OBJFORMAT],ABSFORMAT]) is 
an optional parameter which allows you to supply an IPL program 
to replace an existing IPL program or add one to the volume. 


This parameter should not be used when reformatting a Mass 
Storage System staging pack. 


The IPLDD and BOOTSTRAP parameters are used! to speci fy one of 
the following: 


e If you do not specify IPLDD, ICKDSF writes special bootstrap 
records that cause the processing unit to be placed in a 
WAIT state if the volume 15 Spectres during an attempt to 
load the system. 

e If you specify IPLDD but do not specify BOOTSTRAP, ICKDSF 
supplies an IPL bootstrap which is written on the volume 
together with the IPL text you supply. 

e If you specify IPLDD and BOOTSTRAP, ICKDSF uses the IPL 
bootstrap and the IPL text you supply. If neccesary, ICKDSF 
updates the bootstrap records to allow for possible user 
labels. 

The maximum size permitted for the IPL program record depends 


upon the type of volume being reformatted. The maximum sizes 
allowed are: 


| 2305-20 2 13,616 
ean D2 OT 


Also, the number of existing user volume labels. can further 
limit the size allowed for the IPL program if you specify the 
NOPURGE parameter. If you supply an IPL program that exceeds the 
size allowed, you receive an error message but the reformatting 
continues. . 


For dname, substitute 1 to 8 alphameric characters for the DD 
statement identifying the data set that contains the IPL program 
you want written on the volume being reformatted. The IPL 
program can be specified within the OS/VS JCL input stream 
CSYSIN). If the IPL program is in the OS/VS JCL input stream, 
the data must be included . immediately after the REFORMAT 
command. For reformatting in a stand-alone. environment, the 
dname must be specified as SYSIN. 
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For diblname, substitute 1 to 7 alphameric characters. These 
represent the file name that appears in the DLBL statement and 
identify the file that contains the IPL program you want written 
on the volume being reformatted. The IPL program can be included 
in the DOS/VSE JCS input stream (SYSIN). It must then be 
included td after the REFORMAT command. 


OBJFORMAT | 
Specifies that IPL data is Seine Suaeiied in object deck 
format, that is, cards will have one of the following 
strings of EBCDIC characters in columns 2 through 4: 


TXT 
RLD 
ESD 
END 


Note that only cards with TXT will be processed. All others 
Will be ignored. 


OBJFORMAT may be abbreviated as OBJECT or OBJ. 


ABSFORMAT | 
Specifies that IPL data 1s being supplied in the form of 
variable-length records that contain executable 
instructions. When IPL data is supplied in this format, it 
15 necessary to provide a minimum of three records. The 
maximum number of records supplied and their lengths are 
only limited by the track capacity of the volume on which 
these records are to be written. 


The first two records supplied must be the bootstrap 
records and are restricted to lengths of 24 and 144 bytes. 


The contents of the IPL records and the contents of the 
program are not checked by ICKDSF. It is the user's 
responsibility to ensure that the IPL records can load an 
executable program. The first IPL record must contain a PSW 
followed by two CCWs (channel command words). The CCHs 
should have the following hexadecimal formats: 


First CCW O06xxxxxx 600000390 
Second CCW 08xxxxxx 00000000 


The first CCW is a command to read in the second IPL record 
at main storage address xxxxxx. The second CCW is a | 
transfer-in-channel command (a eee to the CCW that 
begins the second IPL record. 


The second IPL record must be 144 bytes long. Bytes 32 
through 42 Cstarting from byte zero) cannot be used. Bytes 
32 through 42 are used by ICKDSF for the seek address 
Cbytes 32 through 37) and the CCHHR (Cbytes 38 through 42) 
of the third IPL record. 


The third through nth records that are supplied are assumed 
to be IPL program records and will be written on the volume 
Without any modification after the standard volume label 
and any existing user volume labels. Note that the IPL 
program will only be written on the first track of the 
pack. If the records supplied exceed in length the 
remaining space on the first track, the function will 
terminate with an error message, 


ABSFORMAT may be abbreviated as ABSOLUTE or ABS. 
Abbreviations: 
IPLDD| IPL 
Defaults: If you specify the IPLDD parameter without specifying 
the BOOTSTRAP parameter, the IPL bootstrap records necessary to 


transfer control to the IPL program record will be generated 
automatically. 
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Restrictions: In uw stand-alone envirenment, you must substitute 
SYSIN for the dname. 


When an IPL program 1s included in the SYSIN stream, it must 
immediately follow the REFORMAT command and be terminated by an 
ENDIPLTEXT card. The ENDIPLTEXT card is optional when the IPL 
program 15 in a data set other than the one specified by SYSIN, 
or when the end-of-file indicator (/*) immediately follows the 
data for the IPL program. 


This parameter 15 invalid for fixed block architecture devices. 


BOOTSTRAPINOBOOTSTRAP: WRITING IPL BOOTSTRAP RECORDS ON THE VOLUME 


Explanation: BOOTSTRAP|NORGOTSTRAP are optional parameters 
specifying whether you are supplying the IPL bootstrap records 
that are to be written on the volume during reformatting. 


BOOTSTRAP 
Tndicates that you are supplying the IPL bootstrap records 
that are written on the volume during reformatting. These 
records must be the first four records in the IPL program 
text. The first text record must have IPL] in the first 
four columns, followed by 24 bytes of data. The 24 bytes of 
data have the same format as the first IPL record described 
above under ABSFORMAT. The next three text records must 
have IPL2 in their first four columns, followed by 68 bytes 
of data each itn the second and third records and 8 bytes of 
data in the last record. The 144% bytes of data have the 
sama format as IPL record 2 described above under 
ABSFORMAT. 


NOBOOTSTRAP 
Indicates that you are not supplying IPL bootstrap records 
and require that the necessary IPL bootstrap records be 
generated by the Device Support Facilities program. 


Abbreviations: 


BOOTSTRAP | BOOT 
NOBOOTSTRAP | NOBOOTINBOOT 


Defaults: The default is NOBOOTSTRAP. 
Restrictions: The BOOTSTRAP and NOBOCTSTRAP parameters apply 
oniv when the IPLDD parameter is specified. This parameter is 


ignored when the IPL program is supplied in absolute format. 


This parameter is invalid for fixed block architecture devices. 


EXAMPLES OF WAYS TO CODE THE REFORMAT COMMAND 


The following examples show different ways to code the REFORMAT 


command in offline and online mode (COS/VS) and for DOS/VSE. To 


reformat a volume in a stand-alone environment, take an example 
given for OS5S/V5 and do the following: 


° Eliminate the OS/VS JCL. 


® Substitute the UNITADDRESS parameter for the DBDNAME 
parameter. 


® Specify the DEVICETYPE parameter. 
e Substitute SYSIN for dname in the IPLDD parameter. 


Note: Any values specified here are examples only and should not 
be interpreted as the values for your system, 


REFORMAT: Reformatting Portions of a Previously Initialized Volume 85 


REFORMAT 


REFORMATTING A VOLUME TO CHANGE THE VOLUME SERIAL NUMBER IN OFFLINE MODE 
(OS/VS): EXAMPLE 1 


In this example, the volume serial number is being chaneeeh Any 
catalogs that identify the volume by its old volume serial 
number must be modified. The VERIFY parameter is specified to 
ensure that the correct volume is being accessed before the 
volume serial number is changed. 


poe Ne JOB 
EXEC PGM=ICKDSF 
77 SYSPRINT DD hours A 


““SYSIN 
REFORMAT UNITADDRESS(353) VERIFY (OLDVOL) - 
VOLIDCNEWVOL) 
4% 


REFORMATTING A VOLUME TO ADD AN IPL PROGRAM IN ONLINE MODE (OS/VS)> EXAMPLE 2 


In this example, an IPL program is added to the volume, and the 
owner identification is changed. If any user volume labels exist 
on the volume, the IPL program is written over them because the 
PURGE parameter is specified. The Device Support Facilities 
program will supply the appropriate IPL bootstrap records. 


/7EXAMPLE2 JOB 

// EXEC PGM=ICKDSF 
/7IPLDECK DD x 

e 


@ 
@ 
//NOLUMEL DD UNIT=3330,DISP=OLD, VOL=SER=VOL123 
//SYSPRINT DD SYSOUT=A 
“/SYSIN DD x 
REFORMAT DDNAMECVOLUMEL) IPLDDCIPLDECK) - 
OWNERIDCBROWN) PURGE NOVERIFY 
7% 


REFORMATTING A VOLUME TO CHANGE THE VOLUME SERIAL NUMBER (DOS/VSE): EXAMPLE 3 


In this example, the volume serial number is verified and a new 
volume serial number is assigned. 


// JQB jobname 
// KSSGN S$Y¥S$010,151 
f/f EXEC ICKDSF,SIZE=AUTO 
REFORMAT SYSNAMECSYS010) VERIFYCOLDVOL) VOLIDCNEWVOL) 
/¥ 
7 & 


REFORMATTING A FIXED BLOCK ARCHITECTURE VCLUME TO CHANGE THE VOLUME SERIAL 
NUMBER (DOS/VSE): EXAMPLE 4 


In this example, the volume serial number and owner ID are 
verified and a new volume serial number and owner ID are 


assigned. 
// JOB jobname 
// SSSGN S$YS010,380 | 
// EXEC ICKDSF,SIZE=AUTO 


REFORMAT SYSNAMECSYS010) VERIFYCOLDVOL,SMITH) ~ 
VOLIDCNEWVOL) OWNERIDCJONES) 
1X® 
7% 
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REFORMATTING A FIXED BLOCK ARCHITECTURE VOLUME TO CHANGE THE VOLUME SERIAL AND 
BLANK OUT THE OWNER-ID (DOS/VSE): EXAMPLE 5 


In this example, the volume serial number and owner ID are 
verified, a new volume serial number iS assigned, and the owner 
ID is blanked. 


“7 SOB jobname 
// ASSGN $Y5011,381 
// EXEC ICKDSF,SIZE=AUTO 


REFORMAT SYSNAMECSYSO11) VERIFYCOLDVOL,JONES) - 


VOLIDCNEWVOL) OWNERIDC'b!) 
/¥* 


1% 


where the b in 'b* is a blank character. 
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Figure 8 shows the general layout of a disk pack in count key 
data format, from the lowest~numbered cylinder and track through 
the highest-numbered cylinder and track. 


- Cylinder 0:0 Track 
| 
ae, 1:0 


HHA To 


2:0 


2:nnnn 
T:nnann 


\ 
O:nnnn 


Figure 8. General Volume Layout (Count Key Data Devices) 


Figure 3 on page 893 shows that, immediately after its index 
point, each track on a count key data device begins with a home 
address that describes the track type and condition. The home 

address is followed by a record 0 that links defactive primary 
tracks with their associated alternate tracks. After the home 

address and record 0, there are zero or more keyed or nonkeyed 
user-written records. (The 2305 Fixed Head Storage Models 1 and 
2 do not have home address records.) ; 
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Record-2 


Count/Key/ 
Data-2 


Record-1 


Count/Key/ 


Count/ Record-n 
Key/ 


Figure 9. Standard Track Layout (Count Key Data Devices) 


Figure 10 shows an example of the volume map that can be 
received after processing a volume with Device Support 
Facilities with either the INIT or INSPECT command. 


ICKDSF DEVICE SUPPORT FACILITIES TIME: 09:14:01 05/17/78 PAGE 1 
INIT DDNAMECINPUT) PURGE CHECK(1) VTOC(0,19,10) VOLIDCNEWVOL) NOVERIFY 


e 
e 
® 


ICKO13071I DEFECTIVE-TRACK LIST IN HEXADECIMAL FOR VOLUME NEWVOL 
ICKO01308I THE FOLLOWING PRIMARY TRACKS WERE FOUND DEFECTIVE: 
CCHH OF TRACK ~~ CCHH OF ALTERNATE ~~ FLAGGED DEFECTIVE ~- TRACK CONDITION 


00D4 0008 0328 0000 YES DEFECTIVE 
OODB 0008 0328 0001 Teo DEFECTIVE 
0189 0000 9328 0002 YES DEFECTIVE 
018C 0011 0328 0903 YES DEFECTIVE 
O20F 0005 0328 0004 YES DEFECTIVE 
0224 O00D 0328 0005 YES NOT-DEFECTIVE 
027B OOO0E 0328 0006 YES DEFECTIVE 
O2CE 0003 0328 0007 YES NOT-DEFECTIVE 
0307 OOD0A 0328 0008 YES DEFECTIVE 

ICKO1309I THE FOLLOWING ALTERNATE TRACKS WERE FOUND DEFECTIVE: 

CCHH OF TRACK -~ CCHH OF PRIMARY ---- FLAGGED DEFECTIVE -- TRACK CONDITION 

032B 000D 032B O00D | YES DEFECTIVE 

ICKO1L313I VOLUME CONTAINS 133 ALTERNATE TRACKS -- 123 AVAILABLE. 

ICKO01314I VTOC IS LOCATED AT CCHH=X'0000 000A" AND IS 10 TRACKS. 


ICKOO001I FUNCTION COMPLETED. HIGHEST CONDITION CODE WAS 0 


Figure 10. 


Volume Map Output (Count Key Data Devices) 
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2 


90 


Legend for the volume map: 


dis 


Message ICK01307I is the first line of the volume map; it 
identifies the volume serial number for which the map is 
produced. 


Message ICK01308I is printed as the second line of the 
volume map when one or more defective primary tracks were 
found. 


Note: Only as a result of medial ‘and maximal initialization 
Will all defective tracks be listed in the volume map. 
Minimal initialization and the INSPECT command result in a 
list of only those tracks that were checked during execution 
of the respective command, namely, the alternate tracks and 
the individual:vtracks inspected, respectively. Some'of the 
tracks listed may not be defective, because the list may 
include tracks that are marked defective because of 
unconditional assignment of alternate tracks. 


Four columns of information are provided: 


CCHH OF TRACK: The penadee inal track address of the 
defective primary track. 


CCHH OF ALTERNATE: The hexadecimal track address of the 
alternate track assigned to the primary track. If a primary 
track is marked defective but does not have an associated 
alternate track, this column contains the primary track 
address. 


FLAGGED DEFECTIVE: A YES indicates that the home address 
flag byte has its defective-track flag on; a NO indicates 
that the defective-track flag is off. 


TRACK CONDITION: This column is printed only if the CHECK 
parameter was specified with the command or if an 
unrecoverable track was found. DEFECTIVE indicates that the 
track could not be read without a DATA CHECK occurring. 
NOT-DEFECTIVE indicates that the track could be read and 
written without difficulty. The NOT-DEFECTIVE condition 
appears only when the RECLAIM parameter is not specified, 
and indicates that the defective-track flag was on and, 
although the track did not appear to have defects, it was 
not reclaimed. UNRECOVERABLE indicates that surface checking 
could not be performed because I/O errors occurred, that 
prevented either the home address or the record 0 from being 
written on the track. 


Message ICK01309I1I appears when one or more alternate tracks 
are found defective. The same information 15 provided for 
alternate tracks as 1s provided for primary tracks, but the 
second column identifies the primary track associated with 
the alternate track. | 


Note: In some cases, the track address for the primary track 
is the same track address as that for the alternate track, 
which indicates that the alternate track is not associated 
with a primary track. When an alternate track is found 
unrecoverable, the "FLAGGED DEFECTIVE" column is blank,» and 
the primary track address is set to NONE. 


Message ICK01313I1I indicates the number of alternate tracks 
defined for the volume and the number of alternate tracks 
that are neither defective nor assigned. 


Message ICK01314I1I identifies the track address where the 
volume table of contents begins and the number of tracks 
reserved for it. 
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Figure 11 shows the contents of cylinder 0, track 0 after the 
volume has been initialized. The first track of the first 
cylinder is reserved for system-defined records: 


° Home address and record 0 

° IPL bootstrap records 

° Volume label 

e Optional user-volume labels 


e Optional IPL program 


IPL 
Bootstrap 


User- 
Volume 
Label-1 


IPL 
Program 


Figure 11. Cylinder 0, Track 0 Layout (Count Key Data Devices) 


Figure 12 shows how the primary and alternate track associations 
are recorded on the volume. 
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Alternate Track 
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/ 404 
Track P FccHn | Count area 
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Figure 12. Primary/Alternate Track Association (Count Key Data 
Devices) 


Appendix A. Volume Layout and Record Formats on Count Key Data Devices 91 


Figure 13 shows the contents of the IPL bootstrap records as the 
system supplies them. Each bootstrap record has a count area and 
a 4-byte key area. The key of the first record is IPL1, and the 
count area indicates that its data area is 24 bytes long. The 
key of the second record is IPL2, and the count area indicates 
that its data area is 144 bytes long. Bootstrap record 1 causes 
bootstrap record 2 to be read, and bootstrap record 2 causes the 
IPL program to be read. The IPL program contains user-defined 
values. | 


IPL BScotstrap Record I: 
00000000 00000000 PSW 
06003A98 60000060 CCW: Read 
08003A98 00000000 cCW: TIC 


IPL Bootstrap Record 2: 

O7003AB8 40000006 CCW: Seek 

SLOO0SABE 40000005 CCW: Search Id Equal 
O8003AA0 00000000 CCW: TIC 

06000000 20000000 CCW: Read 
000000000000 Seek Address—~00 
0000000004 Search Address—-R 4 
0000000000000000 Padding | 
0000000000000000 (101 Bytes) 


Figure 13. IPL Bootstrap Records 
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Figure 14 shows the format of the home address on each track. 


When a volume is 
as indicated 


The skip-displacement bytes appear as part of the home address 

record on each track for 3340 direct access storage facility and 
3350 direct access storage devices only. The home address on 
each track for the other supported devices begins with the flag 
byte. 


initialized, 
in the figure. 


the flags for each track are set 


1 Skip Displacement Bytes 
Device dependent: 


3340: 1 SD Byte field 
3350: 3 SD byte fields 


Flags 


01234567 


ow Type 


Figure 14. 
Devices) 


0: Primary 
1: Alternate 


Track Condition 


0: Non-defective 
1: Defective 


Pack Mode 


0: Normal 
1: CE Pack 


Unused (Set Zero) 


Standard Home Address Format (Count Key Data 


Volume Layout and Record Formats on Count Key Data Devices 
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Figure 15 shows the format of record 0. When a volume is 
initialized, the record 0 is written immediately following the 
home address on each track. Record 0 contains a flag byte, a. 
track address, its key length, and its data length. The flag 
bits are set as indicated in the figure. 


The record 0 on each primary track contains its own track 
address unless it has been assigned an alternate track. If the 
primary track has been assigned an alternate track, the assigned 
alternate track address is written in the primary track's racord 


« 


The record 0 on each alternate track contains its own track | 
address unless it has been assigned to a primary track. If the 
alternate track has been assigned to a primary track, the 
assigned primary track address is written ih the alternate 
track's record 0. 


Pa Flags (Not transmitted) 
01234567 


— Track Type 


0: Primary 
1: Alternate 


Track Condition 
0: Non-defective 
1: Defective 


Unused (Set Zero) 


Record Overflow 
0: Logical Record End 


1: Logical Record continued 
on next track 


Unused (Set Zero) 


S 


Track Address of self-samne track, or of associated Alternate or Primary (the 
R value is always zero) 


Key-length Always zero (0) 


Data-length Always eight (8) 


4 
5 


Figure 15. Standard Record 0 Format (Count Key Data Devices) 


Data-Area Always eight bytes: binary zeros when initialized by ICKDSF 
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This appendix explains only minidisk support. A VM/370 user is 
able to initialize or inspect either a real disk or a virtual 
disk (YM minidisk). Initialization of a partial disk as an 05 
minidisk in the ¥M/370 environment is available only in the 
stand-alone environment. The following devices are supported as 
minidisks: 


2314, 2319, 2305-1, 2305-2, 3310, 3330, 3330-11, 3330V, 3340, 
3344, 3350, 3370, 3375, and 3380. 


° 2305/3330/3330V/3340/3350/3375/3380 DASD Devices 


The only level of initialization provided is minimal 
initialization. A volume label, VTOC, and, optionally, 
IPL records can be written. Alternate tracks are not 
provided. 


Pack inspection is not allowed on these devices, as 
Writing of home-~addresses and standard-length record 
zeros is tnhibited on these devices in the VM 
environment. 


® 2314/2319 DASD Devices 


Minimal, medial, and maximal initialization are 
provided. The last cylinder of the 2314 minidisk is 
always reserved for use as an alternate track cylinder. | 
Therefore, a 2314 minidisk will always have a minimum of 
2 cylinders. The initialization function uses the last 
cylinder of the minidisk as an alternate track cylinder. 


All the functions provided by the INSPECT command are 
available for a 2314/2319 minidisk. 


To specify the number of cylinders in the INIT and INSPECT 
commands for an OS minidisk inh the VM environment use: 


MIMICCMINICn) ) 


where n = number of cylinders 


Note: For 2305/3330/3330V/3340/3350/3375/3380 devices, "n" 
datermines the actual amount of space on that volume, that 
is, reflected in the VTOC's DSCB Format-4 record. For 2314, 
the last cylinder is always reserved as the alternate track 
cylinder. Therefore, only "n-1" cylinders are available as 
primary cylinders, that is, reflected in the VTOC's DSCB 
Format-4 record. . 


| * 3310/3370 Fixed Block Architecture (FBA) DASD Devices 
The only level of initialization supported is minimal. 
Volume labels and a fixed block architecture VTOC can be 
written. No surface checking or alternate block 
assignment is provided. 


Do not specify the MIMIC parameter when you initialize 
3310 or 3370 volumes. 
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This appendix contains all Device Support Facilities messages 
with the ICK prefix. 


For ease of reference, you might want to remove this appendix 
from the publication and insert it in one of the following 
publications: 


e VSE/Advanced Function Messages, $C€33-6098, if you use Device 
Support Facilities in a VSE environiient 


>: VS1 System Messages, GC38-1001, if 
you use Device Support Facilities in.a VS1 environment 


_@ OS/VS Message Library: V52 System Messages, GC38-1002, if 
you use Device Support Facilities in an MVS environment 


INTRODUCTION 


Messages are detailed as fully as possible to permit you to 
understand a condition and to take necessary action. Information 
for each message includes, when appropriate: 


e Explanation: What the message means, why it appears, what 
caused it, what its variable fields are. 


® System Action: What is happening as a result of the 
condition causing the message. For example, is the system 
waiting for responses. 


® Operator and/or Programmer Response: If a response is 
necessary, who performs it, what the pertinent responses 
are, and their effect on the system or program. 


° Problem Determination: If the problem recurs or is. 
persistent to the point that system efficiency suffers, what 
actions can be performed to obtain adequate data for trained 
hardware or programming support personnel to diagnose the 
problem. 


The last item, problem determination, will often refer to the 
tabular listing of problem determination actions in Appendix D. 
These common action tables do not teach diagnostic techniques, 
but instruct the operator or programmer what to do when problems 
recur. The problem determination actions are aids to identify 
hardware or programming problems and they ensure that support 
personnel have the essential programming information available 
to diagnose and correct the difficulty. 


MESSAGE ROUTING AND DESCRIPTOR CODES 
Routing codes provide the ability to route system operator 
messages to selected funtional areas. 
Device Support Facilities messages will be routed to default 
functional areas as defined by a specific installation or, in 
the absence of such definition, they will be routed to the 
master console. 


The descriptor codes will always indicate system status. 
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Component Name ICK 
Program Producing Message Device Support Facilities 


Audience and Where Produced For operator: the operator's console. For system 
programmer: printed output. 


Message Format ICK s nnnn t text or ICK nnn t text 


Ss 
Condition code indicating severity of message 
received at the output printer. Messages 
received at the console do not have a 
condition code indicating severity. 


Information: no effect upon execution 
Warning: function might fail 

Error: function probably failed 
Serious Error: function failed 
Terminal error: Device Support 
Facilities processor terminated 


BUN © 


It is possible to determine which of several 
messages issued during execution of a command 
results in a specific condition code value: 
The highest condition code multiplied by four 
yields the command's setting of the LASTCC. 


nnnn or wAnnNn 
Message serial number: four digits for printed 
messages, and three digits for messages that 
appear at the operator's console. 


Type code: 


Informational, no action required 
Eventual action required 

Decision required, processing waiting 
Operator action required . 


ome 


text 
Message text 


** Indicates a 'second-level" message that 
further explains a preceding message. The 
track addresses (€cccc:hhhh) in message text 
appear in hexadecimal format. 


Associated Publications None 


Problem Determination If the problem recurs, perform the problem 

| determination actions to ensure that qualified 
support personnel will have the essential 
programming information available to diagnose and 
correct the difficulty. Refer to Appendix D for 
problem determination instructions. 
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MESSAGES RECEIVED AT THE CONSOLE 


ICKOOLD CONFIRM PURGING OF 
UNEXPIRED DATA SETS, REPLY 
U TO PURGE, ELSE T 

Explanation: Before processing 


starts, if one or more unexpired data 
sets have been found, the operator 15s 
requested to confirm that the volume 
contents may be destroyed. 


System Action: Device Support 
Facilities waits for the operator's 
response. 


Operator Response: Respond U to 
permit unconditional purging of the 
data set; or respond T to prohibit 
purging and to terminate the function. 


Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKO02D ERROR IN REPLY, REPLY 'U" 
oR 'T? | 


Explanation: When replying to. 
messages whose only acceptable 
response is U or T, the operator | 
responded with another character. Any 
other character will cause this 
request for reentry to be made. 


System Action: Device Support 
Factlities waits for the operator's 
response. 


Operator Response: Respond with U for 
unconditional PUPgUngs or T to 
terminate. 


Programmer Response: None. 


Problem Determination: Not 
applicable. : 


ICKOO3D REPLY 'U" TO ALTER VOLUME 


cuu CONTENTS, ELSE ‘T' 


Explanation: When processing the 
volume cuu offline, the operator is 
requested to confirm the processing 
because the offline volume is not 
checked by the operating system, and 
data on the volume might be lost or 


modified. Depending on the command and > 


parameter used, this data might be as 
little as the volume serial CREFORMAT 


command with VOLID parameter), a track 


CINSPECT with NOPRESERVE), or the 
whole volume CINIT with CHECK). 


System Action: Device Support 
Facilities waits for operator's reply. 


$ystem Action: 


Operator Response: Respond U to 
proceed with command processing} 
respond T to terminate the command. 


Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKOO0O4D READY DEVICE cuu AND REPLY 
"U", ELSE 'T* 
Explanation: The device cuu is not in 


the READY state. 


System Action: Device Support 
Facilities waits for the operator's 
response. 


Operator Response: Ensure that the 
device is in the READY state, and 


- respond U to continue processing the 


command or respond T to terminate the 
command. 


Programmer Response: None. 


Problem BDatermination: Not 
applicable. 


ICKOO5E DEFINE INPUT DEVICE: 


*xxxx,cuu’ or *CONSOLE'’ 


Explanation: xxxx is the device type 
and cuu 1s the.channel and unit 
address. This message appears only in 
a stand-alone environment. The 


operator must specify the device type 


and location of the command input 
stream. 


Device Support 
Facilities waits for the operator's 
response. 

Operator Response: Specify the input 
device type and its channel and unit 
address. 

Programmer Response: None. 


Problem Determination: Not 


applicable. 


ICKOOGE DEFINE OUTPUT DEVICE: 
| *xxxx,cuu" or ‘CONSOLE’ 
Explanation: xxxx is the device type 


and cuu is the channel and unit 
address. This message appears only in 
a stand-alone environment. The 
operator must specify the device type 
and the location of the printed 
output. 


System Action: Device Support 
Facilities waits for a reply. 


Operator Response: Specify the output 
device type and its channel and unit 
phe tly 
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Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKOO7VE INVALID INPUT DEVICE 
SPECIFIED 
Explanation: This message appears 


only in a stand-alone environment. The 
operator specified an invalid device 
type to message ICKOOS5E. 


System Actien: Device Support 
Facilities repeats message ICKOOS5E. 


Coereaetor Response: 
input device type. 


Specify a correct 


Programmer Response: None. 


Problem Determination: 
2, 3, 4, and 29g. 


Table I, items 


ICKOQSE INVALID QUTPUT DEVICE 
SPECIFIED 
Explanation: This message appears 


only tn a stand-alone environment. The 
operator specified an invalid device 
type to message ICKOQO6E. 


System Action: Device Support 
Facilities repeats message ICKO06E. 


Cnerator Response: 
output device type. 


Specify a correct 


Programmer Response: None. 


Problem Determination: 
25 3% 4G, and 29. 


Table I, items 


ICKOO9I SVC INTERRUPT OCCURRED 
Explanation: This message appears 
only in a stand-alone environment. 
Probable program error. The SVC 
Instruction cannot be used in a 
stand-alone environment. 


System Action: Device Support 
Facilities terminates. 


Operator Response: 
programmer. 


Notify the system 


Programmer Response: 
Determination. 


See Problem 


Problem Determination: 
2% 53 4G, and 29. 


Table I, items 


ICKOLOI PROGRAM INTERRUPT OCCURRED 
Explanation: This message appears 
only in a stand-alone environment. 
Probable program error. An instruction 
exacuted incorrectly. 


Appendix C. 


System Action: Device Support 
Facilities terminates. 


Operator Response: 
programmer. 


Notify the system 


Programmer Response: 
Determination. 


See Problem 


Problem Determination: 
2» 3» 4 and 29. 


Table I, items 


ICKOLIE I/O ERROR -- error-type, 
cuu, command, CSW, sense 
Explanation: This message appears 


only in a stand-alone environment. An 
I/O error of the type indicated 
occurred on the device at address cuu. 
The command in error is indicated as 
are the contents of the channel status 
word (CSW) and the results of a sense 
operation against the device. 


System Action: Device Support 
Facilities terminates. 


Operator Response: None. 

Procrammer Response: Correct the 
cause of the error, and restart Device 
Support Facilities. 


Problem Determination: 
2» 3» 4% and 29. 


Table I, items 


ICKO1ZE INTERVENTION REQUIRED, cuu 
Explanation: This message appears 
only in a stand-alone environment. The 
indicated device is not in the READY 
state. 


System Action: Device Support 
Facilities waits for correction of the 
problem. | 


Operator Response: Ensure that the 
device 1s in a READY state. 
Pragrammer Response: None. 


Problem Determination: Not 
applicable. 


ICKOL3E CONSOLE READ FAILED, 
REENTER LAST LINE 
Explanation: This message appears 


only in a stand-alone environment. An 
I/0 error occurred when attempting to 
read a line that was entered at the 
operator's console. 


System Action: Device Support 
Facilities waits for the line to be 
reentered. 


Operator Response: Reenter the line. 
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None. 


Table I, items 


Programmer Response: 


Problem Datermination: 
ar 53 4, and 29. 


SET DEVICE cuu IN 


ICK914D ee 4: u IN 
WRITE-NODE AND REPLY ‘U',; 
ELSE '‘'T!* 
Explanation: The device at address 


cuu 18 set in read-only mode. 


System Action: Device Support 
Facilities waits for operator's 
response. 


Crerator Resronse: Set the device to 
allon write operations and reply U. If 
write operations cannot be allowed, 
reply T, and the command terminates. 
Programmer Responses: None. 
Problem Determination: Not 
applicable. 


ICKOISE TODAY'S DATE, REPLY 
"minvdd/yy ' 
Explanation: This message appears 


only in a stand-alone environmant. If 
you want the date to appear as part of 
the output title line, respond with 
the month, day, and year as indicated; 
otherwise, press the ENTER key. 


System Action: The date appears in 
the title line of the output listing, 
or blanks are substituted if a date 
was not supplied. | 


Operator Response: Respond with the 
month, day, and year if you want the 
date to appear in the title line of 
the output listing. If you do not want 
the date, respond by pressing the 
ENTER key. 


Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKOILGE SUPPLY TIME OF DAY, REPLY 
"hh: mms ss ° 
Explanation: This message appears 


only in a stand-alone environment. If 
you want the time of day to appear in 
the title line of the output listing, 
respond with the hour, minute, and 
second as indicated; otherwise, 
respond by pressing the ENTER key. 


Systam Action: The time of day 
appears in the title line of the 
output listing, or blanks are 
substituted if a time of day was not 
specified. 


System Action: 


Operator Response: Respond by 
specifying the hour, minute, and 
second if you want the time of day to | 
appear in the title line of the output 
listing. If you do not want it to 
appear, respond by pressing the ENTER 
key. 


Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKO17D filename IS A SECURED FILE 
Explanation: The specified 'filename' 
is a data-secured file and Device 
Support Facilities requests permission 
to purge this file in an associated 
message, ICKO18D. 


Processing continues, 
as the message is informational only. 


Operator Response: None. 


ICKO18D CONFIRM PURGING OF | 
SPECIFIED FILE NANE, REPLY 
U TO PURGE, ELSE T 

Explanation: The filename is 


displayed in message ICK017D and 
permission is being requested to purge 
the filename specified in message 
TICKO17D. 


System Action: Processing continues 
after the correct reply is obtained 
from the operator. If the operator 
replies T, the command terminates and 
Device Support Facilities continues 
processing with the next command. If 
the operator rerlies U, processing of 
the command continues. 


Operator Response: The operator must 
reply to this message with either U or 
Tx 


Programmer Response: None. 


ICKO19D CONFIRM PURGING OF ALL VSAM 
FILES, REPLY U TO PURGE, 


ELSE T 


Explanation: Permission is being 
requested to purge all VSAM files in 
the DOS/VSE environment. Note that 
this message is issued once only Cupon 
discovery of the first VSAM file on 
the volume). 


System Action: Processing continues 
after the correct reply is obtained 
from the operator. If the operator 
replies T, the command terminates and 
Davicea Support Facilities continues 
processing with the next command. If 
the operator replies U, processing of 
the command continues. 
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Operator Response: The operator must 
reply to this message witn either U or 
T. 


Programmer Response: None. | 


ICKOZOD DEVICE cuu IS SHARED. REPLY 
U OR T 
Explanation: The volume addressed by 


the "cuu™ +5 being shared, and Device 
Support Facilites requests permission 
to operate on the subject volume. 


System Action: Processing continues 
after the correct reply is obtained 
from the operator. If the operator 
replies JT, the command terminates and 
Device Support Facilities continues 
processtag with the next command. If 
the operator replies U , processing of 
the command continues. 


Operator Response: The operator must 
reply to this message with either U or 
Te 


Programmer Resronse: None. 


ICKO57I INVALID DEVICE TYPE: VTOC 
THDEX NOT SUPFORTED ON THIS 
DEVICE 

Explanation: The device type is not a 


valid device type for initialization 
with a VTOC index. 


System Action: The creation of the 
¥TOC index is not attempted. INIT 
command processing continues. 


Operator Responsa2: None. 


Programmer Resmence: None. 


ICKO58&I cuu I/O ERROR DETECTED 
DURING INDEX CREATION: 
ERRO®? CODE= x 

Explanation: An I/O error occurred 


during VTOC index creation processing. 
Error codes: 


1 ~- Error occurred reading volume 
label 

~ Error occurred reading VTOC 

Error occurred writing VTOC 

~ Error occurred writing index 

records 

~ Index extent violated; increase 
index size 


un BAR 
t 


System Action: VTOC index creation 
processing 15 terminated. The BOS 
volume indicator is turned on in the 
VTCC. INIT command processing 
continues. 


Operator Response: Refer the error 
indication to the system coordinator 
for problem determination. 


Proqrammner Response: None. 


ICKOS59I INDEX STARTING LOCATION 
INVALID AS SPECIFIED 
Explanation: The INDEX parameter on 


the INIT command statement is invalid. 
The starting location, as specified, 
is not valid for one of the following 
reasons: 


1. It caused an overlap with the 
VTOC. 


2. It defined cylinder zero, track 
zero as the starting location of 
the index data set. 


3 it Was outsiae the physical limits 
of the daevice. 


4. The relative track specified is 
invalid for the device. 


System Action: Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Cneck the values 
specified for the INDEX parameter and 


correct the value in error. Resubmit 
the job. 


ICKO61I cuu VTOC INDEX CREATION 
SUCCESSFUL: VOLUNE NOW IN 


INDEX FORMAT 


Explanation: The VTOC index was 

successfully created on the volume. 
System Action: None. 
Operator Response: None. 


Programmer Response: None. 


ICKO062I cuu VTOC INDEX CREATION 
FAILED: RETURN CODE= 8 
Explanation: Index creation was 


unsuccessful. 


System Action: None. 


Operator Response: None. 

Programmer Response: Check the job 
output for additional information on 
the reason for job failure. 


ICK400T cuu ANALYZE STARTED 
Explanation: ANALYZE has started to 
execute its tests on the logical 
volume identified in the message (that 
is, on the volume whose unit address 
is cuu). 
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System Action: Processing continues. 


Crerator Ressonse: None 


ICKSO1I cuu SUSPECTED DRIVE PROBLEM 
Explanation: During the drive tests, 
ANALYZE detected an error. , 

data verification test, ANALYZE 
detected an error other than data 
check. 


System Action: ANALYZE processing 
terminates, and message ICK406I 
CICK014906I) is issued. 


Operator Response: Depending on your 
installation'’s procedures, you might 
do the following: 


° Restore the entire volume to 
another drive from a backup 
volume. 

° Discontinue using the drive. 


Save the console output and ANALYZE’s 
printer output, which contain further 
information about the hardware 
problems. 


Take the action appropriate to your 
installation's procedures for handling 
suspected equipment problems. If the 
problem recurs, contact your IBM 
Customer Engineer or Service 
Representative. 


ICK402I cuu ERROR READING DATA 
Explanation: ANALYZE detected data 
checks while reading. data. This 
message 1s followed on the printer by 
a message that identifies the track 
and cylinder number on which each data 
check occurred. The cause of the 
problem could be a damaged disk 
surface or an intermittent read/write 
circuitry failure. 


System Action: ANALYZE processing 
terminates, and message ICK406I 
CICKG14061I) is issued. 


Operator Response: Depending on your 
‘installation's procedures, you might 
do one of the following: 


@ Restore the entire volume from a 
backup volume. 


® Rebuild the track that has the 
error. 


® Assign an alternate track and then 
restore the track. 


e Rebuild the data set. 


Save the console output and ANALYZE'’s 
printer output, which contain further 
information. 


Problem Pere ne eaen: Table I, items 


l,; 2» 3» 4» 


ICK403I cuu DATA SCAN VALUES 
INVALID, TESTING TERMINATED 
Explanation: The relative block 


number(s), tracks, or cylinders 
specified by the LIMITS parameter are 
invalid. 
Systam Action: Data verification is 
not done. 


Operator Response: Specify valid 
relative block number(s), tracks, or 
cylinders in the LIMITS parameter and 
rasubmit the request. 


ICK406I1 Cuu VOLUNE HAS UNFORMATTED 
DATA BLOOKS 
Explanation: An attempt was made to 


read a data block which was not 
initialized (data field not written). 


System Action: After 504 data checks, 
the ANALYZE command is terminated. 


Operator Response: Perform 
appropriate procedures to recover all 
desired data from the volume and then 
run the DOS utilities INTDK or INTDSK 
with the 'IQ@' option to initialize all 
data blocks. 


ICK4O05I1 cuu ALL DATA "MACHINE 
READABLE’ WITHOUT ERRORS 
Explanation: The volume was 


successfully read during the data 
verification test (SCAN option). 


System Action: ANALYZE processing 
tarminates normally, and message 
ICK406I CICK014061) is issued. 


Operator Response: None. CIf a data 
problem prompted you to run ANALYZE, 

and if the problem persists, further 

analysis is needed according to your 

installation's procedures. ) 


ICK4061 


Explanation: 
processing. 


cuu ANALYZE ENDED 
ANALYZE has completed 


System Action: 
terminates. 


ANALYZE processing 


Operator Response: None. 
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ICK&07I cuu NO DRIVE PROBLEMS FOUND 
Explanation: ANALYZE successfully 
completed executing the drive tests 
and did not detect any problems. 


System Action: If the SCAN option was 
specified or defaulted, ANALYZE 
processing continues with the data 
verification test. Otherwise, ANALYZE 
processing terminates, and message 
ICK406I CICK014061I) is issued. 


Operator Response: None. (If a data 
problem prompted you to run ANALYZE, 
and if the problem persists, run the 
data verification test. If a drive 
problem prompted you to run ANALYZE, 
and if the problem persists, further 
analysis 18s needed according to your 
installation's procedures. ) 


ICK408I cuu DATA VERIFICATION TEST 
STARTED 
Explanation: ANALYZE has started to 


execute its data verification tests. 


System Action: Processing continues. 


Operator Response: None. 


ICK410I MAIN STORAGE NOT AVAILABLE, 


TESTING TERMINATED 


Explanation: Dynamic acquisition of 
storage for work areas and control 
blocks failed. 


System Action: ANALYZE command 
processing 15 terminated. 


Operator Response: 
storage size. 


Increase main 


ICKG411I INCORRECT DEVICE TYPE; 
TESTING TERMINATED 
Explanation: The device type 


specified for the ANALYZE volume is 
not supported by ANALYZE. 


System Action: 
terminated. 


ANALYZE processing is 


Operator Response: See Figure 2 on 
page 4 for valid device types. 


ICK41eI DEVICE NOT READY, TESTING 
TERMINATED 
Explanation: A condition occurred 


which caused "Intervention Required" 
to be posted in the failing CSW sense 
byte. 


System Action: The ANALYZE command is 
terminated. 


Operator Response: Ready the drive, 
and reissue the command. 


ICKS$131 DATA FORMAT UNACCEPTABLE, 
TESTING TERMINATED 
Explanation: Data on the cylinder is 


Written in a format other than the IBM 
standard format, or an intermittent 
drive error occurred during the data 
verification test, or the volume under 
test was accessed by another program 
that erased an EOD record after it was 
read by the data verification test and 
before it was reread by the test. 


System Action: 
terminated. 


ANALYZE processing 15 


Operator Response: None. 


ICK4141 WRITE INHIBIT SWITCH ON; 
WRITE TESTS BYPASSED 
Explanation: An error is detected 


when ANALYZE attempts to write a 
record anc fails because the "R/W" or 
"READ™ switch is in the "READ" 
position, or the "READ/WRITE™ switch 
position is defective. 


System Action: All tests that attempt 
to write on the CE cylinder are 
bypassed. 


Operator Response: Set the 
YWREAD/WRITE” switch in "WRITE" mode. 


ICK415I INVALID UNITADDRESS, 
SYSNAME GR DDNAME SPECIFIED 
Explanation: The channel and unit 


addresses specified do not exist in 
the system I/0 configuration, or the 
DDNAME 18S incorrect, or the SYSNAME is 
incorrect. | 


System Action: ANALYZE command 
processing 1s terminated. 


Operator Response: Correct the values 
specified for "cuu"™ in the UNITADDRESS 
parameter, or correct the DDNAME 
specified, or correct the SYSNAME 
specified, then reissue the command. 


ICK416I UNABLE TO OPEN VOLUME 
Explanation: The volume that was 
specified cannot be OPENed. The DD 
statament could be missing or invalid, 
or the channel and unit address could 
be invalid. 
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System Action: 
tarminated. 


Operator Response: Correct the error, 
and reissue the command. 


ICK4$171I WRITE TESTS BYPASSED 
Explanation: A bad home address on 
the CE cylinder was detected while 
trying to verify positioning of the 
access mechanism. 


System Action: All write-dependent 
tests are bypassed. 
Ceerater Response: None. 


Problem Betermination: Table I, items 
2> 3» 4, 30. 


ICK501I INVALID DEVICE TYPE 
: SPECIFIED FOR BUILDIX 
| COMMAND 
Explanation: A request was made to 


change the format of a VTOC on a 
volume whose davice type is not 
supported by the BUILDIX command (Cfor 
example, a 2314 DASD). 


System Action: Execution of the 
command 1s terminated. 


Operator Response: None. 


ICKS02.I BUILDIX FUNCTION STARTED 


Explanation: Execution of the BUILDIX 
command has begun. 
System Action: None. 


Operator Response: None. 


ICKS5O3I cuu REQUEST RECEIVED TO 
CONVERT VTOC TO *XFORMAT 
Explanation: This message verifies 


the raquest for a change of VTOC 
format. '®X! specifies the format 
requested--either OS or IX 


System Action: Execution of the 
command continues. 


Ceerator Response: None. 


ICK504I1 cuu VTOC FORMAT IS | 
CURRENTLY *XFORMAT, REQUEST 
ACCEPTED 

Explanation: This message verifies 


that the BUILDIX function specified on 


the command statement is valid for the 
current format of the VTOC on the 
volume. '**' identifies the format of 


The ANALYZE command is- 


the VTOC, either OS or IX. 


System Action: Execution of the 
command continues. 


Cperator Response: None.. 


ICKS051 cuu VTOC FORMAT IS 
CURRENTLY *XFORMAT, REQUEST 
REJECTED 

Explanation: The format of the VTOC 


is currently the same as the format 
requested in the BUILDIX command 
statement. 'X*' identifies the format 
of the VTOC, either OS or Ix. 


System Action: Execution of the 
command is terminated. 


Operator Response: None. 


ICK508A cuu SHOULD VTOC CONVERSION 
PROCEED? REPLY "u"™ TO 
CONTINUE, ELSE "c" 

Explanation: This message permits the 


operator to verify that the user is 
authorized to request the BUILDIX 
function before execution of the 
command begins. 


System Action: The system will wait 
for the operator's reply. 


Operator Response: Verify that the 
user is authorized to issue the 
command, and reply ‘Ut to continue. 
Any reply other than 'U' will be 
interpreted as a cancellation request. 


ICK509I cuu DIRF FLAG SET IN VTOC; 
BUILDIX CANNOT PROCEED 
Explanation: An error. occurred during 


VTOC processing on a previous job, 
causing the DADSM interrupt flag to be 
set in the VTOC. The VTOC is not 
accurate. 


System Action: Execution of the 
command is terminated. 


Operator Response: Prepare a job that 
will cause reconstruction of the VTOC 
and run it against the volume. (For 
example, run an IEFBR14¢ job to 
allocate a temporary data set to the 
volume.) On conclusion of this job, 
resubmit the BUILDIX command. 


ICK5101 cuu BUILDIX REQUEST 
| CANCELLED DUE TO OPERATOR 
ACTION 
Explanation: The operator replied 


'CANCEL' to a message requiring a 
response. 
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System Action: Execution of the 
command is terminated. 


Crerator Response: None. 


ICKSLII cuu CVAF ERROR: RETURN 
CODE=*¥xX ERROR CONDITION= 
KKK . 

Explanation: The common VTOC access 


facility returned to Device Support 
Facilities with a return code 
indicating either a logical error ora 
physical error. Return codes have the 
following meanings: 


4, 


Indicate logical errors 

8 
Indicates an invalid index 
structure 

16 


Indicates an I/0Q error 


The error condition will be printed 
only for a return code of 4 or 8. See 
Appendix B of Data Facility Device 
Support: User’s Guide and Reference 
for more information on these error 
conditions. 


System Action: Execution of the 
command terminates with the following 
conditions existing, depending on the 
return code: 


4, 8, l2 
The volume is left tn OSVTOC 
format. 

16 


The volume is left as it was 
before the command was issued. 


Operator Response: None. 


ICK5121I cuu ERROR: SYS1L.VTOCIX. IS 
A VIO DATASET. BUILDIX 
TERMINATED. 

Explanation: The index data set was 


allocated as a VIO data seat and is not 
supported by the BUILDIX command. 


System Action: Execution of the 
command terminates with a return code 
of 12. The VTOC is left unchanged. 


Operator Response: None. 


ICK513I cuu BUILDIX PROCESSING 
COMPLETED: VTOC IS NON IN 
XXFORMAT. 

Explanation: The BUILDIX command 


completed successfully. '**" shows the 
new VTOC format, either OS or IX. 


System Action: Device Support 
Facilities is terminated normally. 


Operator Response: None. 


ICK5141 INDEXED VTOC FACILITY NOT 
ON SYSTEM. BUILDIX 
TERMINATED. 

Explanation: <A request was made to 


change a VTOC to IXVTOC format, but 
the system does not contain indexed 
VTOC programming support. 


System Action: Execution of the 
command is terminated. 


Operator Response: None. 


ICKS5151 cuu BUILDIX COMMAND FAILED. 
RETURN CODE= 8 
Explanation: An error occurred that 


caused execution of the command to be 
terminated. 


System Action: Execution of the 
command is terminated. 


Operator Response: None. 


ICK5162 cuu I/O ERROR DETECTED 
DURING VTGC CONVERSION: 
ERROR CODE= x 

Explanation: An I/0 error occurred 


during BUILDIX processing. Error 
codes: 


1 - Error occurred in reading the 
volume label 


2 - Error occurred in reading the 
VTOC 

3 - Error occurred in writing the 
VTOC 

4 - Error occurred in writing 
index records 

5 - Index extent was violated; 


increase index size 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: Refer the error 
indication to the system coordinator 
for problem determination. 


ICK517I1 cuu ERROR: VOLUME IS A DOS 
STACKED PACK 
Explanation: The volume being 


processed has a VTOC on the first 
track of the volume. VTOC conversion 
is not possible on such a volume. 


System Action: Execution of the 
command is terminated. 


Operator Response: None. 
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ICK5181 cuu ERROR: VOLUME CONTAINS 


SPLIT CYLINDER EXTENTS 


Explanation: It was found that the 
volume contains one or more shared 
extent data sets. These are not 
supported by the BUILDIX command. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: None. 


ICK5191 cuu ERROR: SYS1.VTOCIX. 


DATASET NOT FOUND CN VOLUME 


Explanation: 
not be found on the voluma. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: None. 


ICK520I cuu ERROR: DUPLICATE INDEX 
DATASET NAME FOUND ON | 
VOLUNE 

Explanation: Two data sets were found 


on the volume that had names beginning 
with SYSL.VTOCIX. Only one per volume 
is allowed. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: = None. 


ICK5211 cuu ERROR: INDEX DATASET 
EXTENT NOT CONTIGUOUS 
Explanation: The index data set was 


found to occupy more than one extent. 
This data set must occupy one, and 
only one, extent. 


System Action: Execution of the 
BUILDIX command 1s terminated. 


Operator Response: None. 


ICK522I INVALID DDNAME SPECIFIED 
Explanation: The DDname is incorrect 
in the command statement. 


System Action: Execution of the 
BUILDIX command is terminated. 


Overator Response: Correct the job 
control statement and resubmit the 
job. 


Explanation: 


The index data set could | 


| Operator Response: 


ICK524I UNABLE TO OPEN VOLUME 


The volume specified 
cannot be opened. The DD statement 
could be missing or invalid. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: Correct the error, 
and resubmit the job. 
ICK600I MAPALT STARTED 


Explanation: Execution has started 
for the MAPALT command. 
System Action: None. 


Operator Response: None. 


ICK602I INCORRECT DEVICETYPE; 
MAPALT TERMINATED 
Explanation: The device type 


specified is not supported by the 


MAPALT command. 


System Action: Execution of the 
MAPALT command is terminated. 


MAPALT can only be 
executed on fixed block devices in 
fixed block mode. 


Programmer Response: None. 


ICK603I ‘UNABLE TO OPEN VOLUME 


Explanation: The volume that was | 

specified cannot be opened. The ASSGN 

statement could be missing or invalid, 
or the channel and unit address could 
ba invalid. 


System Action: Execution of the 
MAPALT command is terminated. 


Operator Response: Correct the error 
and resubmit the job. 


Programmer Response: None. 


ICK604I  cuu LIMITS PARAMETER 
INVALID AS SPECIFIED, 
MAPALT TERMINATED 

Explanation: The relative block 


numbers(s) specified by the LIMITS 
parameter are invalid. 


System Action: Execution of the 
MAPALT command is terminated. 


Operator Response: Correct the 
value(s) in the LIMITS parameter, and 
resubmit the job. 
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Programmer Response: None. 


ICK605I1 cuu UMNRECOVERABLE I/0 ERROR 
DETECTED, MAPALT TERMINATED 
Explanation: An unrecoverable I/0 


error Cother than a data check) was 
encountered. 


System Action: Execution of the 
MAPALT command is terminated. 


Cperator Response: Check the job 
output, which will contain diagnostic 
information to aid in analyzing the 
error. Execute the Device Support 
Facilities ANALYZE command as a 
problem determination aid, and follow 
installation procedures for recovery 
from this type of error. 


Programmoar Response: None 


ICKSO06I nnnnn BLOCKS ASSIGNED TO 
ALTERNATES IN LIMITS 
SPECIFIED 

Explanation: This summary message 


shows the number of blocks that were 
assigned to alvernates within the 
limits specified on the command 
statement. 


System Action: None. 


Ceerator Response: None. 


Programmer Response: None. 


ICK607I cuu MAPALT ABNORMALLY 
ENDSEB, REPORT WAY BE 
INCOMPLETE 

Explanation: This message is printed 


after an error has been encountered 
that caused execution of the command 
to be terminated. The report may be 
incomplete. 
System Action: None. 

Cperator Response: Check previous. 
messages on job output, and follow 
installation procedures. 


Programmer Response: None. 


ICK608I cuu MAPALT ENDED NORMALLY, 
RETURN CODE= n 
Explanation: Execution of the command 


ended without any errors detected that 
would have caused termination of 
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Operator Response: 


Programmer Response: 


execution. A return code of 0 or 4 
will be indicated in the message. A 
return code of 0 means no errors were 
encountered. A return code of 4 means 
one or more recoverable errors were 
encountered. 


System Action: None. 


None. 


Programmer Response: None. 


ICK609I PERMANENT DATA CHECK FOUND 
READING ID FOR BLOCK nnnnnn 
Explanation: A permanent data check 


was encountered while attempting to 
read the ID field of the primary block 
shown in the message. 


System Action: Diagnostic information 
is printed on the output device, and 
execution of the command continues. 
Operator Response: None. 

Programmar Response: Save the job 
output for the system coordinator, and 
follow installation procedures for 
data recovery and/or assignment of an 
alternate block. 


ICK610I TEMPGRARY DATA CHECK FOUND 
READING ID FOR BLOCK nnnnnn 
Explanation: <A temporary data check 


while attempting to read the ID field 
of the primary block shown in the 
message. 


System Action: Diagnostic information 
is printed on the output device and 
execution of the command continues. 
Operator Response: None. 

Save the job 
output for the system coordinator and 
follow installation procedures for 
logging and tracking temporary error 
conditions. 


ICK611I MAIN STORAGE NOT AVAILABLE, 
-MAPALT TERMINATED 
Explanation: Dynamic acquisition of 


storage for control blocks and work 
areas failed. 
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Note: 


System Action: Execution of the 
MAPALT command is terminated. 


Orerator Response: 
storage size, 


Increase main 
and resubmit the job. 


Programmer Response: None. 


ICK70Q51 VOLUME SERIAL NUMBER FOR 
DEVICE cuu IS xxXxxxx 
Explanation: Informational message 


concerning the volume serial and/or 
VTOC of the volume at cuu. If the 
volume serial was changed, you also 
receive one or both of the following: 


CHANGED FROM xxxxxx - The volume 
serial number of thea cuu was changed. 


The following message could also be 
received: 


VOLUME SERIAL DUPLICATE FOR DEVICE 
cuu. VOLUME MADE UNAVAILABLE - The new 
volume serial on the cuu is a | 
duplicate of one already known to the 
operating system. The device has been 
unloaded. 


If the VTOC location was changed, 
also receive the following: 


VTOC LOCATION MOVED - The VTOC 
location of the volume at cuu has 
moved. 


you 


System Action: Device Support 

Facilities continues processing. 
Operator Response: None. 
Proadrammer Response: None. 


Problem Determination: Not 
applicable. 


MESSAGES RECEIVED AT THE OUTPUT 


FRINTER 


ICKOQOOI1I FUNCTION COMPLETED, HIGHEST 


CONDITION CODE WAS nn 


Explanation: A command has been 
executed; the value nn is the last 
condition code CLASTCC) generated 
during execution of the command. 


The LASTCC value is the highest 
condition code found in the messages 
printed during execution of the 
command. 


System Action: LASTCC is set to nn; 
MAXCC is set to nn if nn is greater 
than the current value of MAXCC. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: Not 


applicable. 


ICKOO0002I ICKDSF PROCESSING COMPLETE. 
| MAXIMUM CONDITION CODE HAS 
nn 
Explanation: This message is issued 


upon completion of a Davice Support 
Facilities job step. The highest 
condition code (MAXCC) set during the 
job step is printed (see message 
ICKO0Q001I) and returned to the Device 
Support Facilities invoker in register 
15. 


System Action: None. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: Not 


applicable. 


ICKOO0COSI PRECEDING COMMAND BYPASSED 
} DUE TO CONDITION CODES 
Explanation: The IF-THEN-ELSE command 


sequence that was specified caused the 
command to be bypassed. When 
specifying an IF-THEN-ELSE command 
sequence, either the THEN or the ELSE 
clause 15s executed, and the one not 
executed is bypassed. 


System Action: The bypassed portion 
of the command sequence is checked for 
syntax errors but 15 not executed. 
Device Support Facilities processing 
continues. 


Operator Response: None. 

Programmer Response: None. 

Problem Determination: Table I, items 
1s: 2» Sy Ss -and 29. 

ICKOO0206I IMPROPERLY PLACED COMMA HAS 


BEEN FOUND AND IGNORED 


Explanation: A redundant comma was 
encountered when scanning the command, 
It is ignored. The omission of 
positional parameters cannot be 
indicated by commas; the omission of 
leading positional parameters is not 
permitted. 


System Action: The command is | 
executed. : 


Cperator Response: None. 
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Programmer Response: Correct the 
syntax error to prevent the message 
from occurring. 
Prablem Determination: Table I, items 
2» & and 29. 


ICKO0022eI WARNING: COMMAND~END 
DELIMITER APPEARS WITHIN 
APOSSTROPHES 

Explanation: The optional command 


delimiter, a semicolon, was found 
within a quoted string. A closing 
singie quotation mark may have been 
omitted. 


System Action: The usage is accepted, 
and the semicolon is treated as a 
valid character instead of a 
delimiter. 
Creratcr Response: None. 

Programmer Response: Check the usage 
of the semicolon, and correct if 
necessary. 


Preblem Determination: Table I, items 
2» 4, and 29. 


ICKO0233I TOO MANY RIGHT PARENTHESES 
FOUND. EXCESS IGNORED 
Explanation: Too many closing 


parentheses were found at the end of 
the command or following a first-level 
parameter. 


System Action: The excess is ignored, 
and the command continues processing. 


Creerator Respanse: None. 


Frogrammer Raspoansa: Remove the 


excess parentheses. 


Problem Determination: 
cr» 4 and 29. 


Table I, items 


ICKO02342% WARNING: TOO FEW RIGHT 
PARENTHESES FOUND AT END OF 
COMMAND 

Explanation: Too few closing 


parentheses wera found at the end of 
the command to properly close the 
subparameter Lists. 


System Action: The omission is 
accepted. Device Support Facilities 
processing of the command continues. 
Operator Response: None. 
Programmer Response: Correct the 
command syntax. | 
Problem Determination: 
2» G, and 29. 


Table I, items 
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ICKOO0700I cuu BEING PROCESSED AS 
LOGICAL DEVICE = xxxx 


PHYSICAL DEVICE = yyyy 


Explanation: The device at address 
cuu 1S being processed as a logical 
device type of xxxx anda physical 
device type of yyyy. 


System Action: Device Support 
Facilities processing of the command 
continues. 
Operator Response: None. 
Programmer Response: None. 


Problem Determination: Not 
applicable. — 


ICKOICI6I ALTERNATE TRACK 
CCHH=X'ecce hhhh' ASSIGNED 
TO PRIMARY TRACK 
CCHH=xX‘'tcecce hhhh* 

Explanation: An alternate track was 


assigned to a primary track because 
the primary track was marked 
defective, or was found to be 
defective by surface checking, or an 
unconditional alternate track 
assignment was requested for the 
primary track. | 
System Action: The command continues 
processing. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKOLO1LS8I ALTERNATE CCHH=xX'’ccee hhhh’ 
RE-ASSIGNED FOR PRIMARY 
CCHH=X'eccce hhh’ 

Explanation: Tha alternate track 


originally assigned to the indicated 
primary track was either marked 
defective or was found defective 
through surface checking. Another 
alternate track was assigned in place 
of the original alternate track. If 
the PRESERVE option was specified, the 
data found on the original alternate 
track was copied to the new alternate 
track. 

System Action: The command continues 
processing. 


Operator Response: None. 


Programmer Response: None. 


Problem Datermination: Not 
applicable. : 
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ALTERNATE TRACK | 
CCHH=X*cccc hhh" WAS 
RECLAIMED 


ICKOLOZOI 


Explanation: An alternate track that 
was previously marked defective 
appeared to be nondefective when 
surface checking was performed. The 


track is added to the set of available 


alternate tracks. 


System Action: 
processing. 


Operator Response: None. 
Programmer Resrense: None. 


Problem Datermination: Not 
applicable. 


ICKOLO21I PRIMARY TRACK 
CCHH=X"*ecece Khhh’ WAS 
RECLAIMED 

Explanation: A primary track that was 


previously marked defective appeared 
to be nondefective when surface | 
checking was performed. The primary 
track is marked available, and the 
assigned alternate track is added back 
into the set of available alternate 
tracks. If the PRESERVE parameter was 
specified, any data written on the | 
alternate track 15 copied back onto 
the reclaimed primary track. 


System Action: The command continues 
processing. 


Cperator Response: None. 
Programmer Response: None. 


Problem Determination: Not 
applicable. 


ICKO1302I NO VTOC FOUND ON VOLUME, 
INITIALIZATION CONTINUES 


Explanation: During initialization, 
Device Support Facilities did not find 
a volume table of contents. Therefore, 
the program cannot identify data sets 
that should not ba purged. 


System Action: The initialization 
continues and creates a volume table 
of contents on the volume. 


Operator Response: None. 


Programmer Response: If the 
Initialization was performed at the 
minimal level, the data on the tracks 
is usually not destroyed, and it is 
possible to retrieve the data if 
necessary. 


Problem Datermination: Not 
applicable. 


ICKO13071 


The command continues | 


System Action: 


DEFECTIVE TRACK LIST FOR 


VOLUME volid 
Explanation: This message is the 


first line of the volume map. 
Following this line is a list of any 
tracks that were found defective 
during execution of the command. 


System Action: 


The command completed 
successfully. | 


Operator Response: None. 


Programmer Response: None. 


Problem pacer mace Not 


applicable 
ICKOLSOSI THE FOLLOWING PRIMARY 
| TRACKS WERE FOUND 
| DEFECTIVE: | 
Explanation: this message is a line 


in the volume map that identifies any 
primary tracks that were found 
defective during execution of the 
command. | 


The command completed 
successfully. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: Not 


applicable. 


~—~ICKOISZO9SI THE FOLLOWING ALTERNATE 

| TRACKS WERE FOUND 
DEFECTIVE: 

Explanation: This message is a line 


in the volume map that identifies any 
alternate tracks that were found 
defectiva during execution of the 
command. 


System Action: 
successfully. 


The command completed 


Qperator Response: None. 
Programmer Response: None. 


Problem Determination: Not 


applicable. 


ICKO1310I NO DEFECTIVE TRACKS WERE 
FOUND 


Explanation: This message is a line 
in the volume map that indicates that 
no defective tracks were found during 
execution of the command. If the 
command did not specify that all the 
tracks were to be checked, tracks that 
were not checked could be defective. 
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System Action: 
successfully. 


The command completed 


Onerator Response: None. 


Frodrammar Response: None. 


Problem Determination: Not 
applicable. 


ICKOISLII NO DEFECTIVE PRIMARY TRACKS 
WERE FOUND 
Explanation: This message is a line 


in the volume map that indicates that 
no defective primary tracks were found 
during execution of the command. This 
does not mean that no defective 
primary tracks exist if the command 
did not specify that all the primary 
tracks are to be checked. 


System Action: 
successfully. 


The command completed 


OQnerator Response: None. 


Programmer Respons@: None. 
Problem Determination: Not 
applicable. 


ICKO1312I NO DEFECTIVE ALTERNATE 


TRACKS HERE FOUND 


Explanation: This message is a line 
in the volume map that indicates that 
no defective alternate tracks were 
found during execution of the command. 
This message does not mean that no 
defective alternate tracks exist on 
the volume if the command did not 
specify that ell of the alternate 
tracks are to be checked. 


System Action: 
successfully. 


Tne command completed 


OQreratcr Respanse: None. 


Frogrammer Response: None. 


Problem Datermination: Not 
applicable. 


ICKOLISI3I VOLUNE CONTAINS nnnn 
ALTERNATE TRACKS -=- minmmn 
AVAILABLE 

Explanation: This message is a line 


in the volume map. The volume is 
defined as having nnnn alternate 
tracks reserved; mmmm tracks have not 
been assigned to defective primary 
tracks nor have been found to be 
defective and unavailable for 
assignment. 


System Action: 
successfully. 


The command completed 
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Operator Response: None. 


Programmer Response: None. 
Problem Determination: Not 
applicable. 


ICKO1314I VTac IS LOCATED AT 
CCHH=X'cece hhh’ AND IS 
XXXX TRACKS 


Explanation: This message is a line 
in the volume map that indicates the 
cylinder and track where the volume 
table of contents begins and the 
number of tracks it occupies. 


System Action: 
successfully. 


The command completed 


Operator Response: None. 


Programmer Response: None. 
Problem Datermination: Not 
applicable. 


ICKO1400I cuu ANALYZE STARTED 
Explanation: ANALYZE has started to 
execute its tests on the logical 
volume identified in the message (that 
is, on the volume whose unit address 
1S cuud). 


System Action: Processing continues. 


Operator Response: None 


ICKO14052 cuu ALL DATA "MACHINE 
READABLE’ WITHOUT ERRORS 
Explanation: The volume was 


successfully read during the data 
verification test (SCAN option). 


System Action: ANALYZE processing 
terminates normally, and message 
ICK406I CICK01406I) is 1ssued. 


Crerator Response: None. (CIf a data 
problem prompted you to run ANALYZE, 

and if the problem persists, further 

analysis is needed according to your 

installation's procedures.) 


ICKO1406I1 


Explanation: 
processing. 


cuu ANALYZE ENDED 
ANALYZE has completed 


System Action: 
terminates. 


ANALYZE processing 


Operator Response: None. 
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ICKO1407I cuu NO DRIVE PROBLEMS FOUND 
Explanation: ANALYZE successfully 
completed executing the drive tests 
and did not detect any problems. 


System Action: If the SCAN option was 
specified or defaulted, ANALYZE 
mrocessing continues with tha data 
verification test. Otherwise, ANALYZE 
processing terminates, and message 
ICK406I CICKO01¢061I) is issued. 


Orerator Response: None. CIf a data 
problem prompted you to run ANALYZE, 
and if the problem persists, run the 
data verification test. If a drive 
problem prompted you to run ANALYZE, 
and if the problem persists, further 
analysis 1s needed according to your 
insta ilation' S§ procedures.) 


ICKOI408I cuu DATA VERIFICATION TEST 
STARTED 
Explanation: ANALYZE has started to 


execute its data verification tests. 


System Action: Processing continues. 


Operator Respense: None. 


ICKOIG14I2 WRITE INHIBIT SWITCH ON, 


BRITE TESTS BYPASSED 


Explanaticon: An error is detected 
when ANALYZE attempts to write a 
record and faiis because the "R/W" or 
WREAD™ switch 1s in the "READ" 
position, or the "READ/WRITE” switch 
position 15 defective. 


System Action: All tests which 
attempt to write on the CE evlinder 
are bypassed. 


Opera tor Response: Set the 
WREAD/WRITE" switch in "WRITE™ mode. 


ICKGLS1S5I INVALID UNITADDRESS, 
SYSNAME QR BDNANE SPECIFIED 
Explanatien: The channel and unit 


addrass specified do not axist in the 
system I/O configuration, or the 
DDNAME 1S incorrect, or the SYSNAME is 
incorrect. 


System Action: ANALYZE command 
processing 1s terminated. 


Operator Response: Correct the values 
specified for “"cuu™ in the UNITADDRESS 
parameter, or correct the DDNAME 
specified, or correct the SYSNAME 
specified, then reissue the command. 


ICK01416I UNABLE TO OPEN VOLUME 
Explanation: The volume that was 
specified cannot be OPENed. The DD 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 
System Action: The ANALYZE command is 
tarmiaated. 


Qperator Response: Correct the error, 
and reissue the command. 


ICKOLGI7I WRITE TESTS BYPASSED: BAD 
HOHE ADDRESS DETECTED GN 
C.E. CYLINDER 

Explanation: A bad home address on 


the CE cylinder was detected while 
trying to verify positioning of the 
access mechanism. 


System Action: All write-dependent 
tests are bypassed. 


OQperater Response: None. 


ICKGLS0LI INVALID DEVICE TYPE 
SPECIFIED FOR BUILDIX 
COMMAND 

Explanation: A request was made to 


change the format of a YVTOC ona 
volume whose device type 15 not 
supported by the BUILDIX command (for 
example, a 2314 DASD). 


System Action: Execution of the 
command is terminated. 


Operator ResHOnee: None. | 

Pregra mnar Response: Verify that the 
volume is on a device type supported 
by the BUILDIX command, and change the 
JCL or command statement. 

ICKOI502I BUILDIX FUNCTION STARTED 


Explanation: Execution of the BUILDIX 
command has begun. 


System Action: None. 
Operator Response: None. 


Programmer Response: None. 


ICKOISO3I cuu REQUEST RECEIVED TO 
CONVERT VTOC TO X¥FORMAT 
Explanation: This message verifies 


the request for a change of VTOC 
format. ***®" spacifies the format 
requested—either OS or Ix. 
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System Action: Execution of the 
command continues. 
Orerator Response: None. 


Programmer Response: None. 


ICKO1506I cuu VTOC FORMAT IS 
: CURRENTLY XXFORMAT, REQUEST 
ACCEPTED 
Explanatien: This message verifies 


that the BUILDIX function specified on 
the command statemant 15 valid for the 
current format of the VTOC on the 
volume. 'X*"' jdantifies the format of 
the VTOC, either OS or IX. 


System Action: Execution of the 
command continues. 
Operator Response: None. 


Programmer Response: None. 


ICKOISO8A cuu SHOULD VTOC CONVERSION 
PROCEED? REPLY "yu" To 
CONTINUE, ELSE "cr 

Explanation: This message permits the 


operator to verify that the user is 
authorized to request the BUILDIX 
function before execution of the 
command begins. 


System Action: The system will wait 
for the operator's reply. 


Qnerater Response: Verify that the 
user 15 authorized to issue the 
command, and raply "U' to continue. 
Any reply other than 'U' is 
interpreted as a cancellation request. 


Programmer Response: None. 


ICKOIS13I cuu BUILDIX PROCESSING 
COMPLETED: VTOC IS NOW IN 
XR PFORVAT. 


Explanation: The BUILDIX command 
completed successfully. '*xX' shows the 
new VIOC format, either OS or IX. 


System Action: Device Support 
Facilities is terminated normally. 
Crparator Response: None. 


None. 


ICKOIGO0I MAPALT STARTED 


Explanation: Execution has started 
for the MAPALT command. 


System Action: None. 
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Cperator Response: None. 


ICKOI606I nnnnn BLOCKS ASSIGNED TO 
ALTERNATES IN LINITS 


SPECIFIED 


Explanation: This summary message 
shows the number of blocks that were 
assigned to alternates within the 
limits specified on the command 
statement. 


System Action: None. 


Operator Response: None. 


Programmer Response: None. 


ICKOI608I cuu MAPALT ERDED NORMALLY, 
RETURN CODE= n 
Explanation: Execution of the command 


ended without any errors detected that 
would have caused termination of 
execution. A return code of 0 or 4 
will be indicated in the message. A 
return code of 0 means no errors were 
encountered. A return code of 4 means 
one or more recoverable errors were 
encountered. 


System Action: None. 


Operator Response: None. 


Programmer Response: None. 


ICKOL609I PERMANENT DATA CHECK FOUND 
READING ID FOR BLOCK nnannnn 
Explanation: A permanent data check 


was encountered while attempting to 
read the ID field of the primary block 
shown in the message. 


System Actien: Diagnostic information 
iS printed on the output device, and 
execution of the command continues. 
Cperator Response: None. 
Programmer Response: Save the job 
output for the system coordinator, and 
follow installation procedures for 
data recovery and/or assignment of an 
alternate block. 
Problem Betermination: Table I, items 
1, 2, 3, 4, 29 


ICKO1701I ONLY S&S USER LABELS ALLOWED 
Explenation: Only five user volume 
labels are allowed for fixed block 
architecture devices. In the LABEL 
parameter, you have asked for space. 
for more than five labels. 
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Gpsrater Response: 


System Action: 
Six labels, and processing continues. 
None. 

Programmer Response: None. 


Problem Determination: None. 


ICKOL70¢I ALTERNATE ASSIGNED FOR 
BLOCK XXXXXX 
Explanation: Block xxxxxx was found 


defective during surface analysis. The 
block has been assigned an alternate. 

Systein Action: Processing continues. 
Crerator Response: None. 
Prodrammer Response: None. 


Problem Determination: None. 


ICKO1708I RECLAIM SUCCESSFUL FOR 
BLOCK XXXXXX 
Explanation: BLOCK xxxxxx has been 


successfully reclaimed. 
System Action: Processing continues. 
Operator Response: None. 
Programmer Resronse: None. 


Problem Determination: None. 


ICKO1714I RECLAIN UNSUCCESSFUL FOR 
BLOCK XXXXXX 
Explanation: The defective block 


XXxXxXxx falled surface analysis and 
could not be reclaimed. 


System Action: An alternate is 
assigned to the block. Processing 
continues. 
Cperator Response: None. 
Programmer Response: None. 


Problem Determination: None. 


ICKOL715I TOTAL NUMBER OF ALTERNATES 
ASSIGNED = number 
Explanation: Gives the total number 


of alternate blocks assigned in this 


run. | 
System Action: Processing continues. 
Operator Response: None. 


Programmer Response: None. 
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Space is reserved for 


NEE IRE 0m? 0 EAE ini 


Problem Determination: None. 


ICKO1725I EXCESSIVE NUMBER OF 
ALTERNATES ASSIGNED FOR A 
CYLINDER | 

Explanation: During initialization of 


a 3370 volume, more than 24 alternates 
were assigned on one cylinder. This 
is more than the number of alternates 
on a cylinder. 


System Action: Processing continues. 


Operator Response: None. 

Programmer Response: This could cause 
performance degradation on the volume. 
Hardware support may be called for. 
Problem Determinaticn: Table I, 
1, 2, 3 ana 4G. 


items 


ICKO1726I nAnnnnn FACTORY FLAGGED 
BLOCKS. 
Explanation: Final message of INIT 


reclaim processing. nnnnnn is the 
number of factory-flagged blocks 
assignad an alternate. 


System Action: INIT processing 
surface analysis phase is started 


Cperator Response: None. 


Programmer Response: None. 


Problem Determination: None. 


ICKO1727I RECLAIM SPECIFIED WITH 


NOCHECK. NO RECLAIM DONE 


Explanation: RECLAIM function was not 
performed, because NOCHECK was 
specified or defaulted. CHECK 15 
required for RECLAIM. 


System Action: 
without RECLAIM. 


Processing continues 


Operator Response: None. 
Programmer Response: Specify CHECK 
and rerun your job 1f RECLAIM is 
wanted. 


Problem Determination: None. 


ICKO1729I SPECIFIED CISIZE ADJUSTED 
TO REXT HIGHER MULTIPLE OF 


DEVICE BLOCKSIZE 


Explanation: When you specify a : 
CISIZE which is not a multiple of 512, 
ICKDSF. rounds the value up to the next 
higher multiple. 
Action: 


System Processing continues. 
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Cyerator Response: None. 


Programmer Response: None. 


Problem Determination: None. 


ICKOL730I RECLAIN AND/OR CHECK NOT 
SUPPORTED FOR FBA 


MINI-DISKS 


Explanation: The CHECK and/or RECLAIM 
function requested is not supported 
for fixed block architecture CFBA) 
minidisks. 


System Action: Processing continues 
Without CHECK or RECLAIM. 


Crerator Response: None. 


Programmer Response: 
or RECLAIM its needed, 
must be initialized. 


None. If CHECK 
the full volume 


Problem Determination: None. 


ICKOL73S1I WAP FUNCTION NOT SUPPORTED 
FOR MINI-DISKS 
Explanation: The MAP parameter was 


specified on the command, but MAP is 
not supported for fixed block 
architecture CFBA) minidisks. 


System Action: Processing continues 
Without MAP function. 


Orerator Response: None. 


Programmer Response: None 


Problem Determination: None. 


ICKOL756I xx OF THE INSPECTED BLOCKS 


HAVE ALTERNATES ASSIGNED 


Explanation: This is the summary 
message printed when MAP is specified. 
xx 15 the number of blocks inspected 
that have alternates assigned. 


System Action: None. 


Crerator Response: None. 
Programmer Response: None. 


Problem Determination: None. 


ICKC1759I USER DATA ON BLOCK xxxxxx 
RESTORED 
Explanation: Processing of the 


command failed with a permanent error, 
and ICKDSF was able to restore the 
data on block xxxxxx before 
terminating the command. 
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System Action: The command is 
terminated because of a previously 
reported error. Processing continues 
With the next command. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: None. 


ICKO1760I SURFACE OF BLOCK xxxxxx 
DEFECTIVE 
Explanation: The check function found 


the surface of block xxxxxx defective. 


If ASSIGN is 
an alternate is assigned. 


System Action: 
specified, 
Operator Response: None. 
Programmer Response: None. 


Problem Determination: None. 


ICKO1L761I SURFACE OF BLOCK xxxxxx NOT 
DEFECTIVE 
Explanation: The check function found 


the surface of block xxxxxx not 
defective. 


System Action: Processing continues 

With the next block. 
Operator Response: None. 
Programmer Response: None. 


Problem Determination: None. 


ICKOL765I NEW ALTERNATE ASSIGNED TO 
BLOCK XXXXXX 
Explanation: Block xxxxxx has been 


assigned a new alternate. 
System Action: Processing continues. 
Operator Response: None. 
Programmer Response: None. 


Problem Determination: None. 


ICK10705I VOLUME SERIAL NUMBER FOR 
DEVICE cuu IS XxXXxXXxXxX 
Explanation: Informational message 


concerning the volume serial and/or 
VTOC of the volume at cuu. If the 
volume serial was changed, you also 
receive one or both of the following: 


CHANGED FROM xxxxxx - The volume 
sarial number of the cuu was changed. 
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| Operator Response: 


| Programmar Response: 


The following message could also be 
received: 


VOLUME SERIAL DUPLICATE FOR DEVICE 
cuu. VOLUME MADE UNAVAILABLE - The new 
volume serial on the cuu 15 a 
duplicate of one already known to the 
operating system. The device has been 
unloaded. 


If the VTOC location was changed, you 
also receive the following: 


VTOC LOCATION MOVED - The VTOC 
location of the volume at cuu has 
maved. 


System Action: Device Support 
Facilities continues processing. 


None. 
None. 


Problem Determination: Not 


applicable. 


ICKIC710I I/706 ERROR OQCURRED ON DEVICE 
cuu 
Explanation: An I/O error occurred on 


the davice whose address is specified 
by cuu. The nature of the I/0 error is 
described on the next two lines, where 
the failing channel command word > 
(CCW), the channel status word (CSW), 
and the sense bytes are printed. 


System Action: The command continues 
processing. Eventual termination of 
the command may occur, but such a 
termination is generally followed with 
a terminating message. 

Operator Response: None. 
Pragrammer Resronse: 
the problem is, indeed, with the 
device. Correct the device problem, 
and retry the command. 


Make sure that 


ICKLIOO5I VTOC DOES NOT EXIST 


Explanation: A volume table of. 
contents was not found on the volume 
during execution of the command. 


System Action: A volume table of 

contents was created, and the command 

continues processing. 

Cperator Response: None. 
None. 


Not 


Programmer Response: 


Problem Determination: 
applicable. 
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System Action: 


Explanation: 


ICK11009I IPL PROGRAM SUPPLIED FOR 
MSS -- IGNORED 
Explanation: <A volume being formatted 


as an MSS staging pack cannot contain 
IPL records. 


System Action: The IPL program 
specified is ignored, and the command 
continues processing. 

None. 


Programmer Response: Remove the IPLDD 
parameter from the command. 


Not 


Operator Response: 


Problem Determination: 
applicable. 


ICK11010I UNABLE TO CLOSE VOLUME 
Explanation: <A system error occurred 
that prevents the volume from baing 
closed properly. 


The command probably 
did not complete successfully because 
the volume did not close when the 
command completed. Device Support 
Facilities processing continues with 
the next command. 


Cperator Response: None. 


None. 


Table I, 


Programmer Response: 


Problem Determination: 


items 
1; Q> 3> 4, and 30. 


ICK11I019I NEXT~AVAILABLE-ALTERNATE 
POINTER OR COUNTER IN VTOC 


IS INVALID | 


Explanation: The value of the pointer 
to the next available alternate track 
or the count of the number of 
alternate tracks that are available is 
in error. 


System Action: Processing continues. 
If it is possible, the value in the 
VTOC is updated when processing 
completes. 
Operator Response: None. 

Prodrammer Response: Reinitialize the 
volume at either the minimal or the 
maximal level. 


Problem Determination: 
l,; 2% S34 G, and 29. 


Table I, items 


ICK11050I VTOC LOCATION SPECIFIED FOR 


MSS STAGING PACK -- IGNORED 


You cannot specify a 
VTOC location for a Mass Storage 
System staging pack. 


Device Support Facilities User's Guide and Reference 


System Action: The VTOC parameter is 
ia@nored, and the command continues 
Processing. 
OQperator Response: None. 

Freerammer Response: Remove the VTOC 
parameter from the command. 

Problem Determination: Not 
applicabie. 


ICKI1051Z LABELS PARAMETER SPECIFIED 
FOR MSS STAGING PACK --~ 


IGNORED 


Explanation: You cannot place user 
volume labels on a Mass Storage System 
staging pack. 


System Action: | 
is ignored, 
processing. 


The LABELS parameter 
and the command continues 


Qrearetor Response: None. 
Proararnyor Response: Ramove the 
LABELS parameter from the command. 
Problem Determination: Not 
applicable. 


ICKLISC6I NO STORAGE AVAILABLE FOR 
PACK HMA? 
Exnlanstion: Buring initialization or 


inspection of a volume, storage is 
dynamically acquired for data elements 
that are collected later to format the 
pack map. A data element was being 
allocated, but storage was not 
available. 


System Action: 
completed, 


The command 15 
but without a pack map. 
OQnereter Response: None. 


Preararmnan Responses 
region Size, 


Specify a larger 
and reissue the command. 


Problem Determination: Table I, items 
5 ey Sy G, and 29. 
ICKi1S15I UNABLE TO READ VOLUME LABEL 


explanation: An I/0 error occurred 
when attempting to read the volume 
label. Because the number of user 
volume labels cannot be determined, 
the IPL program record could be 
written over existing records. 


System Action: The command continues 
processing, but does nat write the IPL 
program records. 


Operator Response: None. 
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Programmer Response: See Problem 


Determination. 
Problem Determination: items 
Ls ar 55 by and 29. 


Table I; 


ICKLI3S28I SKIP DISPLACEMENTS ASSIGNED 
TO TRACK **O0ccO0hh" 
Explanation: Defective areas on the 


track hava been bypassed. ICKDSF 
processing centinues an nondefective 
areas of the track. 

System Action: The command continues 
processing. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: None. 


YICKLI330I UNIT PARAMETER INVALID 


Explanation: 
invalid 


The UNIT parameter is 

in the current environment. 

System Action: The command 
terminates. 

Operator Response: None. 

Correct the 
resubmit the 


Prograinmer Response: 
control statement, and 
30b. 


ICKLISIZZI RECURRING CORRECTABLE DATA 
CHECK ON TRACK CCHH=X*ccce 


hhhh* 


Explanation: Surface analysis for the 
specified track detected at least two 
occurrences of a correctable data 
check. These correctable data checks 
can be processed by the Error Recovery 
Programs CERPs). 


System Action: None. Processing 
continues with the next track. 
Cperator Response: None. 

want to 


the track 
ASSIGN 


Programmer Response: If you 
assign an alternate track to 
in question, specify INSPECT 
NOCHECK. 


Problem Determination: None. 


ICKLISS4I DSF CURRENTLY PROCESSING 
TRACK CORH=X*ceec hhhh' 
Explanation: Information message 


given when Davice Support Facilities 
is performing full volume processing. 
The message is issued to indicate 
Device Support Facilities progress. 
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System Action: None. Processing 
continues with the next track. 


| Operator Response: None. 
| Programmer Response: None. 


| Problem Determination: None. 


| ICK11752I BLOCK xxxxxx OUTSIDE DEVICE 
LINITS 
Explanation: BLOCK number xxxxxx 


specified by the BLOCKS parameters 15 
invalid. 


System Action: The command continues. 
The invalid block number 15 ignored. 


| Operator Response: None. 
Programmwner Response: Resubmit the 


job, specifying tha correct block 
number in the BLOCKS parameter. 


Problem Determination: 
1, 3, and 4. 


Table I, items 


ICKZ001L1Z FUNCTICN CANNOT BE 
EXECUTED. INSUFFICIENT MAIN 
STORAGE 

Explanation: There is not enough 


virtual storage available to execute a 
command. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Respense: None. 


Programmer Response: Increase the 
amount of virtual storage available to 
Device Support Facilities, and reissue 
the command. 


Problem Determination: 


Table I, items 
1, 2» 3, and 29. 3 


ICK20800I UNABLE TQ SCRATCH dsname 
Explanation: An error occurred while 
attempting to scratch the identified 
data set. A subsequent second-level 
message identifies the error. 


System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: See the 


associated messaqe. 


Problem Determination: 


Table I, items 
hie 2 Ss a3 and 29. 


ICK20801I **% NO VOLUME MOUNTED 


Explanation: Volume not mounted. 
System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: Reissue the 
command and make sure the correct 
volume is mounted. 
Problem Determination: Table I, items 
Ly e} oe G4, and 29. 


ICK20802I *% PASSHORD VERIFICATION 
| FAILED 


Explanation: The data set to be 
scratched 15 password protected, and 
the operator did not supply the proper 
password. 


System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 


Cperator Response: None. 
Programmer Response: Reissue the 
command, and specify the correct 
password when. prompted. 


Problem Determination: 
l> 2» 3> a, 25a, and 29 


Table I, items 


ICK20803I *®% DATA SET HAS NOT EXPIRED 
ON VOLUME volser 
Explanation: The PURGE parameter was 


not specified, and the data set's 
retention period has not expired. 


System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 


GCperator Response: None. 


Programmer Response: Specify the 
PURGE parameter if you want to destroy 
the data set, and reissue the command. 
Problem Determination: Table I, items 
1; fy 3» Gs 25a, and 29. 


ICK20804I *% PERMANENT I/O ERROR ON. 
VOLUME 
Explanation: Because of an I/0 error 


condition, the volume table of 
contents cannot be read. 
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System Action: The data set is not 
scratched. Device Support Facilities 
processing continues with the next 
command. 

Cperator Response: None. 

Programmer Response: Either restore 


the volume or initialize the volume 
offline. 


Problem Determination: 
1, 2, 3, %, and 29. 


Tab‘ie I, items 


ICK20805I *x% UNABLE TO MOUNT VOLUME 
volser 


Explanation: An appropriate device 
Was not available for mounting the 
volume. 


System Action: The data set was not 
scratched. Device Support Facilities 
processing continues with the next 
command. 


Qnerator Response: Ensure that a 

device is available for mounting, and 
reissue the command. 
Proaraminear Response: None. 


Problem Determination: 
Ly es 5 G and 29. 


Table I, items 


ICKEO0SO6I *x DATA SET KAS IN USE 
Explanation: The data set to be 
scratched was being used by ancther 
program. 


System Action: The data set is not 
scratched, and the command continues 
processing. 


OQrerator Response: Ensure that no 
other job 15 using the data set Cdo 
not specify DISP=SHR), and reissue the 
cemmand. 

Programmer Respons2®: None. 

Problem Beterminatiaon: Table I, items 
1, 2 3, 4, 25a, 25c, and 29. 


ICKeCO8LO0I x®x INVALID RACE 
AUTHORIZATION 
Explanation: A RACF-protected data 


set resides on the volume. The volume 
cannot be purged, because the user 
does not have the correct 
authorization to scratch the data set. 


System Action: The data set is not 
scratched, and the command terminates. 
Device Support Facilities processing 
continues with the next command. 


Operator Response: None. 
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Programmer Response: None. 


Problem Determination: Table I, items 


1, 2, 3, 4%) and 29 


ICK20950I INVALID FORMAT STRUCTURE 


Explanation: An element of one of the 
static text structures 15 incorrect. 
Probable program error. 


System Action: The request to print a 
line i185 19gnored. The command continues 
processing, but no output 1s printed. 

Operator Response: None. 


Programmer Response: Perform the 
Problem Determination actions. 


Problem Determination: 
<> 34 G, and 23. 


Table I, items 


ICK20951I OUTPUT COLUMN SPECIFIED OUT 
OF RANGE 
Explanation: An output column 


specification 15 outside the allowed 
print line width, for example, beyond 
column 120. Probable program error. 


System Action: This field and 
subsequent fields for the same Line 
are ignored. The command continues 
processing, but no output 1s printed. 
Operator Response: None. 


Programmer Response: Perform the 
Problem Determination actions. 


Problem Daterminaticn: 
2, 3» GS and 29. 


Table I, items 


ICK20952I EXCESSIVE FIELD LENGTH FOR 


BD OR PU CONV 


Explanation: <A binary-to-decimal or 
packed-to-~unpacked conversion length 
was specified greater than 15. 
Probable program error. 


System Action: The default of 15 was 
used, and the command continues 
processing. 
Operator Response: None. 
Programmer Response: Perform the 
Problem Determination actions. 
Problem Determination: Table I, items 
2) 3; 4, and 29. 


ICK20953I A REDO SUB-STRUCTURE IS 
NESTED 
Explanation: A redo structure cannot 


be defined within a set of structures 
to be redone. Probable program error. 
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System Action: The current redo 
operation is terminated. All 

structures are treated only once. 
Orerator Response: None. 


Programmer Response: Perform the 
Problem Determination actions. 


Problem Determination: 
3, 4, and 23. 


Table I, items 


ICK2Z095G6I STATIC TEXT ENTRY REQUESTED 
NOT IN MODULE 
Explanation: A request for a specific 


static text entry in a specified 
static text module could not ba 
resolved. The static text index is 
incorrect, or the programmer has | 
neglected to enter a message into the 
static text module. Probable program 
error. 


Systam Actions The request is 
ignored, and the command continues 
processing. 
Oreratcr Response: None. 
Programmer Reesonsea: Perform the 
Problem Determination actions. 


Problem Determination: 
ne Se G, 26>» and 29. 


Table I, items 


TCK2Z0955I INVALID PACKED DECIMAL 


PIELD 


Explanation: A conversion request for 
packed-to-unpacked decimal encountered 
a digit that was not in the range of 0 
to 9. Probable program error. 


System Action: Conversion stops for 
the current request. The command 
continues precassing without the 
packed-to-unpacked CONVeEFrSION. 
Crerator Response: None. 
Programmer Responses Perform the 
Problam Determination actions. 


Prodlem Determination: 
1, 25 3, % and 29. 


Table I, items 


ICKZICGOI ALTERNATE TRACK 
CCHH=X'’ccee hhhh’ FOUND 
UNRECOVERASBLE 

Explanation: While checking the track: 


surface, error conditions were 
encountered that prevented the 
alternate track's home address or 
record 0 from being rewritten to 
indicate that it is a defective track. 
Since the track cannot be marked 
defective, it cannot be used by the 
operating system. This massage may 
appear if, during execution cf a 
command, the read/write mode switch is 
inadvertently set to READ mode. 


For 2305 Fixed Head Storage Models 1 
and 2, this message indicates that the 
alternate track 15 already assigned 
and that the customer engineer should 
reset the device to replace the 
defective primary track with an 
alternate spare. To make the dynamic 
spare available again, the 2305 device 
must be initial-microprogram-loadad 
and reitnitialized. 


System Action: Device Support 
Facilities processing continues, 
unless the unrecoverable track 
threshold has been reached (see 
message I[CK3i013I). 


Operator Response: None. 


Programmer Response: See Problem 


Datermination. 


Problem Determination: 
Ly Par 3> G, and 293. 


Table I, items 


ICK2LOO1LI PRINARY TRACK 
CCHH=xX*cccce hhhh' FOUND 
UNRECOVERABLE 

Explanation: While checking the track 


surface, error conditions were 
encountered which prevented the 
primary track's home address or record 
0 from being rewritten, to indicate 
that it is a defective track. Since 
the track cannot be marked defective, 
it cannot be used by the operating 
system. This message may appear if, 
during execution of a command, the 
read/write mode switch 15 
inadvertently set to READ mode. 


For 2305 Fixed Head Storace Models 1 
and 2, this message indicates that the 
alternate track is already assigned 
and that the customer engineer should 
reset the device to replace the 
defective primary track with an 
alternate spare. To make the dynamic 
spare available again, the 2305 device 
must be initial-microprogram-loaded 
and reinitialized. 
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System Action: Device Support 
Facilities processing continues, 
unless the unrecoverable track 
threshold is met (see massage 
TCK31013I1). 
Operator Response: None. 
Programmer Response: 
Determination. 


Sea Problem 


Problem Determination: 
1, 2» 33 G, and 29. 


Table I, items 


ITCK21002I INVALID VTOC ORIGIN 
SPECIFICATION FOR TRACK 
CCHH=X*ccece Hhhh" 
Explanation: The VTOC parameter 


specifies an invalid track location 
for the volume table of contents. The 
VTOC cannot begin on cylinder 0, track 
0 or encroach on the alternate track 
area. 


System Action: The command is 
tarminated. ICKDSF continues with the 
next command. 
Crerator Response: None. 

Programmar Response: Either accept 
the default location, or reissue the 


command with a correct location 
specified. 


Problem Determination: 
1, 2 Ss G, and 29. 


Table I, items 


ICK21003I INVALID VTOQC EXTENT 
SPECIFICATION: xxxx 
Explanation: The VTOC parameter 


spacifies an invalid extent Cnumber of 
tracks) for the VTQC area. The VTOC 
cannot have an extent of 0 or encroach 
on the alternate track area. 


System Action: The command is 
terminated. ICKDSF continues with the 
next command. 
Orerator Response: None. 
Programmer Response: Either accept 
the dafault extent, or reissue the 


command with a correct extent 
specified. 


Problem Determination: 
1; cs > G, and 29. 


Table I, items 
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ICK210071 R-ZERO INCORRECT 
“= X CCHH=X'ccce hhhh* 
(X*ccee Ahhh") 
y CCHH=X'cece Rhhh'* 
Explanation: The track address 


portion of record 0 of an alternate 
track Cy CCHH=X'ccec hhhh') points to 
a primary track (x CCHH=X'cccec hhhh'), 
but the track address portion of 
record 0 of the primary track does not 
point to that alternate track. The 
track address portion of the primary 
track's record 0 is shown in 
parentheses. 


x and y are replaced by the character 
Dor N indicating defective or 
nondefective, respectively. 


When scanning the primary tracks, if 
the track address portion of record 0 
of a primary track is tncorrect, the 
Device Support Facilities program 
places FFFF:FFFF in the alternate 
track address field of the message. 
There may or may not be an alternate 
track that points to this primary 
track. 


Systam Action: If the alternate track 
15 not marked defective, it 15 made 
available for assignment. Otherwise, 
the alternate track remains marked 
defective, and the primary track 
remains as found. 
Operator Response: None. 

Programmer Response: Initialize the 
volume at the medial or maximal level 
to correct the track descriptor of the 
primary track. Alternatively, inspect 
the volume and unconditionally assign 
an alternate track to the indicated 
primary track. 


Problem Determination: 
L> 2» 3» G, and 29. 


Table I, items 


IcK21008I UNABLE TO WRITE IPL RECORDS 
Explanation: The IPL program records 
could not be written. Messages printed 
just prior to this message indicate 
the nature of the error. 


System Action: The IPL program 
records are not written, but the 
command continues processing. 


Cperator Response: None. 
Programmer Response: Correct the 
error, and reissue the command. 
Problem Determination: Table I, items 
1, 2; 3> G, and 23% 
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CRITICAL TRACK 
CCHH=X'cece hhhh’ 
DESCRIPTOR INCORRECT 


ICK210111 


Explanatiecn: The critical tracks are 
those tracks that are reserved for the 


volume table of contents and cylinder 
0, track 0. The contents of the record 


0 on the identified track are in 
error. 

System Action: None. 
Operator Response: None. 


Proarammer Response: Reinitialize the 
volume at the medial or maximal level. 


Problem Determination: 
oe 23 5 G, and 23. 


Table I, items 


ICK21014I SURFACE CHECK FUNCTION 
FAILS ON TRACK 
CCHH=xX*cecce hNhhh’ 
Explanation: While writing or reading 


the indicated track, a channel program 
failure other than DATA CHECK 
occurred. 


System Action: The command 
terminates. Device Support Facilities 
continues with the next command. 


Operator Respense: None. 


Programmer Response: 
Determination. 


See Problem 


Problem Determination: 
1» es 55 G, and 298. 


Table I, items 


NO MORE ALTERNATE TRACKS 


ICKZ101L71 
LEFT ON PACK 
Explanation: All nondefective 


alternate tracks have been assigned to 
primary tracks. 


System Action: Assignment of 
alternate tracks ends; execution of 
the command continues. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume at the maximal level to attempt 


to reclaim primary and alternate 
tracks. 


Problem Determination: 
1s 2» ae 4, and 29. 


Table I, items 


Operator Rasponse: 


ICK21028I1 NOT ALLOWED TO CHANGE 
VOLUME LABEL 
Explanation: Only an authorized user 


can change the volume label ona 
volume in a system that has Resource 
Access Control Facility CRACF) 
installed. 


System Action: The contents of the 
volume label are not changed, but the 
command continues processing. 


Cperator Response: None. 


Programmer Response: None. 


Problem Determination: 
1; es 3» G, and 23. 


Table I, 1tems 


ICK21030I NOT ALLONED TO WRITE IPL 
RECORDS | 
Explanation: Only an authorized user 


can change the IPL records on a volume 
in a system that has Resource Access 
Control Facility CRACF) installed. 


System Action: The IPL records are 
not written, but the command continues 
processing. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: 
1 24 3; 4, and 29. 


Table I, items 


ICK21LO031I UNABLE TO RECLAIM ALTERNATE 
TRACK CCHH=X'ccce hhhh* 
Explanation: An I/0 error occurred 


when attempting to rewrite the home 
address. and record 0 on the indicated 
alternate track. 


System Action: The alternate track is 
not reclaimed. The command continues 
processing. 


None. 


Programmer Responses See Problem 


Determination. 


Problem Determination: 
i, 2» a3 4, and 23: 


Table I, items 


ICK21O032I UNABLE TO RECLAIM PRIMARY 
TRACK CCHH=X'ccecc hhhh' 
Explanation: An I/0 error occurred 


when attempting to rewrite the home 
address and record 0 on the indicated 
primary track. 


122 Device Support Facilities User's Guide and Reference 


System Action: The primary track is 
not reclaimed. The command continues 
processing. 


Operator Response: None. 


Programmer Response: See Problem 


Determination. 


Problem Determination: 
Ls a> Ss 4G, and 29. 


Table I, items 


ICK21033I TRACK DISSOCIATION FAILED: 
CCHH=xX'ccce hhnhh'* 
Explanation: When reclaiming a 


primary or alternate track, the track 
addresses associating the primary and 
alternate tracks could not be removed 
because an error occurred that 
prevented correct rewriting of the 
record 0Q. | 


System Action: The alternate track is 
marked defective, and the command 
continues processing. | 
Operator Response: None. 
None. 


Table I, items 


Programmar Response: 


Problem Determination: 
1% 2% 55 G, and 29. 


ICK21037I INVALID TRACK ADDRESS 
SPECIFIED: 
CCHH=X'cccec hhhh' 
Explanation: Only tracks within the 


defined primary or alternate track 
areas of a volume can be inspected. 
The error is caused aither by 
specifying a track beyond these areas 
or by a syntax error when specifying 
the track address. 


System Action: The requested action 
on the invalid track 18 ignored, but 
the remainder of the command continues 
processing for any tracks that were 
correctly specified. 
Operator Response: None. 

Programmer Response: Correct the 
invalid specification, and reissue the 
command. 


Preblem Determination: 
15 23 35 4G, and 29. 


Table I, items 


ICK21LO3SZ9I PRINARY TRACK 
CCHH=X'ccce Nhhh* 
DEFECTIVE, NO ALTERNATE <-~ 
DATA SAVED 

Explanation: Surface checking found 


the indicated primary track to be 
defective, but no alternate track 15 
available to be assigned to it. 


Appendix C. 


System Action: The contents of the 
primary track are saved and rewritten 
on the primary track, if possible. The 
command continues processing. 

Operator Response: None. 


Programmer Response: 
volume. 


Rainitialize the 


Problem Determination: 
1, 2» 3» 4G, and 29. 


Table I, items 


ICK21040I PRIMARY TRACK 
CCHH=X'ccce hhhh’* 
DEFECTIVE, NO ALTERNATE -~ 
DATA LOST 

Explanation: Surface checking found 


the indicated track to be defective, 
but no alternate track is available to 
be assigned to it. 


System Action: The contents of the 
primary track are lost and not 
rewritten on the primary track. The 
command continues processing. 


Operator Response: None. 


Programmer Response: Reinitialize the 
volume. 

Problem Determination: Table I, items 
l, Zs 3» 4G, and 29. 


ICK210G1I ALTERNATE TRACK 
CCHH=X'ccce hhhn! DEFECTIVE 
-- DATA SAVED 

Explanation: Surface checking found 


the indicated alternate track to be 
defective, but no alternate track is 
available to be reassigned to it. 


System Action: The contents of the 
alternate track are saved and 
rewritten to the alternate track, if 
possible. The command continues 
processing. 


Operator Response: None. 


Programmer Response: Reinitialize the 
volume. 

Problem Determination: Table I, items 
1, 2» 3> 4, and 29. 


ICK21042I ALTERNATE TRACK 
CCHH=X'ccce HAhnh’ DEFECTIVE 
-- DATA LOST 

Explanation: Surface checking found 


the indicated alternate track to be 
defective, but no alternate track is 
available to be reassigned to it. 


System Action: The contents of the 
alternate track are lost and not 
rewritten on the alternate track. The 
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command continues processing. 
Operator Response: None. 


Programmear Response: 
volume. 


Preblem Determination: 


Table I, items 
l> e% 5% 4G, and 29. 


ICK210464I UNABLE TO PRESERVE <-- 
UNABLE TO REAB TRACK 
CCHH=X'cece Khhh' 

Explanation: A record on the 


indicated cylinder and track could not 
be read because of I/0 errors. 


System Action: The record on the 
indicated track is not lost. The 
command continues processing. 


Operator Response: None. 
Programmer Response: None. 


Problem Datermination: Table I, items 


1, 2» 3,» 4, and 29. 


ICK2Z2104¢7I UNABLE TO PRESERVE -- 
UNABLE TO WRITE TRACK 
CCHH=X'cccc hhhh' 

Explanation: An I/0 error occurred 


that prevented successful write 
operations While attempting to write 
preserved records back to the original 
track or its assigned alternate track. 


System Action: The data on the track 
may have been lost, and the command 
continues processing. 

Operator Response: None. 


Programmer Response: 
volume. 


Reinitialize the 


Problem Determination: 
1, 2, 3, 4, and 29. 


Table I, items 


ICK21068I CYL-0 TRK-O DEFECTIVE, PACK 


UNUS SABLE FOR IPL 


Explanation: Cylinder 0, track 0 has 
been found defective. The track has 
been assigned an alternate track, but 
the volume cannot be used as an IPL 
volume. 


System Action: 
processing. 


The command continues 


Operator Response: None. 


Programmer Response: Call the 
customer engineer if you must use this 
volume as an initial-~program-load 
volume. 


Reinitialize the. 


Problem Determination: 
‘e e% 35 4G, and 29 


Table I, items 


ICK21055I VTOC IS LOCATED ON CYLINDER 
0 HEAD 0 


Explanation: The volume table of 
contents exists on the first track of 
the volume. This prevents the writing 
of IPL program records on the first 
track of the volume. 


System Action: The IPL program 
records are not written on the first 
track of the volume as requested by 
the user. Command processing 
continues. 


Operator Response: None 


Programmer Response: If it is 
necessary to have IPL records on the 
volume, reinitialize the volume with 
the VTOC on any other track other than 
the first track of the volume. 


UNABLE TO OPEN IPL INPUT 


ICK213161 
DATA SET 
Explanation: The data set specified 


by the IPLDD parameter cannot be 
opened. An associated message 
identifies the reason for the $57 Ture. 


System Action: The command continues 
processing, but the IPL program record 
1s not written. 


Operator Response: None. 


Programmer Response: Correct the 
error that was identified in the 
associated message, and reissue the 
command. 


Problem Determination: 
1, 2» 45 4G, and 293. 


Table I, items 


IPL INPUT RECORD-1 FORMAT 


ICK213171 
IMPROPER 
Explanation: The first user-specified 


IPL bootstrap record did not contain 
IPL1 as the first four characters of 
the record. 


System Action: The system-defined IPL 
bootstrap records are written on the 
volume and processing continues. The 
remainder of the user-specified IPL 
bootstrap records and IPL program 
records are ignored. 


Operator Response: None. 


Programmer Response: Correct the IPL 
bootstrap record format and reissue. 
the command, or accept the 
system-defined IPL bootstrap records. 
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Problem Determination: 
Ls 2» 3» 4, and 29. 


Table I, items 


ICK21318I IPL INPUT RECORD-2 FORMAT 
IMPROPER 
Explanation: The second 


user-specified IPL bootstrap record 
did not contain IPL2 as the first four 
characters of the record. 


System Action: The system-defined IPL 
bootstrap records are written on the 
volume and processing continues. The 
user-specified IPL bootstrap records 
and IPL program records are ignored. 
Operatcr Response: None. 

Programmer Response: Correct the IPL 
bootstrap record format and reissue 
the command, or accept the 
system-daefined IPL bootstrap records. 


Problem Detarmination: 
i; 23 3» G, and 29. 


Table I, items 


ICK21319I UNABLE TG WRITE BOOTSTRAP-~1 
RECGRD ON VOLUME 
Explanatien: An I/O error occurred 


when attempting to write the first IPL 
bootstrap record on cylinder 0, track 
0. The volume is unusable for IPL. 


System Action: The command continues 
Processing, but the IPL bootstrap 
records are not written on the volume. 
Cnerator Response: None. 

Programmer Respense: Issue the 
INSPECT command to attempt to reclaim 
the track, or reinitialize the volume. 


Problem Determination: 
2» 3» 4G, and 29. 


Table I, items 


ICKel320I UNABLE TG WRITE BOOTSTRAP-2 
RECORD ON VOLUME | 
Explanation: An I/G error occurred 


when attempting to write the second 
IPL bootstrap record on cylinder 0, 
track 0. The volume is unusable for 
ne ee 


System Action: The command continues 
processing, but the IPL bootstrap 
records are not written on the volume. 
Cperator Response: None. 
Programiner Response: Issue the 


INSPECT command to attempt to reclaim 
the track, or reinitialize the volume. 


Problem Determination: 
1, 2, 3, 4, and 29. 


Table I, items 
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ICK21321I UNABLE TO WRITE IPL PROGRAM 
ON VOLUME 
Explanation: An I/0 error occurred 


when attempting to write the IPL 
program record on the volume. The 
volume is unusable for IPL. 


System Action: The command continues 
processing, but the IPL program record. 
is not written on the volume. 


Operator Response: None. 


Programmer Response: Issue the 
INSPECT command to attempt to reclaim 
the track, or reinitialize the volume. 


Problem Determination: 
l, ae a 4, and 23. 


Table I, items 


ICK2l322I CALCULATED IPL PROGRAM 
LENGTH IS EXCESSIVE 
Explanation: The total number of 


bytes required by the user-specified 
IPL program exceeds the maximum 
permitted for the volume being 
initialized. 


System Action: The command continues 
processing, but the IPL program is not 
Written on the volume. 

Operator Response: None. 

Progranmer Rasponse: Determine the 
cause of the excessive size, recompile 
or reassemble the IPL program, then 
reissue the command. 
Problem Determination: Table I, items 
1, 2, 3, %, and 29. 


ICK2l1323I IPL PROGRAM INPUT CONTAINS 
NO TXT CARDS 
Explanation: The input records 


specified for the IPL program source 
were read, but contained no records 
that were identified as standard text 
(TXT) records. 


System Action: The IPLDD parameter is 
ignored, and the command continues 
processing. 
Operator Response: None. 

Programmer Response: Be sure the 
correct input is supplied in the input 
stream or in the specified data set. 


Problem Determination: 
1. ae 34 4, and 29. 


Table I, items 
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TICK2l1755I READ FOR PRESERVE OF BLOCK 
XMXXXX FAILED: — 
NON-CORRECTABLE DATA 
CHECKS-PROCESSING OF BLOCK 


TERMINATED 


Explanation: The user data on block 
XXXXxXxX could not be read because of 
permanent data checks. 


System Action: Diagnostic information 
is printed on the ouput device. 
Processing of the block is terminated 
to prevent the loss of the user data 
on the block. Processing continues 
With the next valid block specified in 
the BLOCKS parameter. 

Crerater Response: None. 

Pragrammer Rasponse: Start error 
recovery procedures for the data set 
containing the block in error, and 
rerun the command for the block in 
error with NOPRESERVE specified. 


Problem Determination: 
1, 2, 3, and &¢. 


Table I, items 


ICKSOQQ0SI FUNCTION TERMINATED. 
CONDITICN COBE IS nn 
Explanation: A command has 


encountered a terminating error 
condition during execution (see 
message ICKO0001I for an explanation 
of nn). Messages printed just prior to 
this message indicate the nature of 
the error. 


Systam Action: Device Support 
Facilities processing continues with 
the next command. LASTCC is set to nn; 
MAXCC is set to nn if nn is greater 
than the current value of MAXCC. 
Operator Response: None. 
Programmer Response: Correct the 
cause of the error, and reissue the 
command. 


Prablem Determination: 
Ley 2? 39 G, and 29. 


Table I, items 


ICK30004I FUNCTICN TERMINATED. 
INSUFFICIENT MAIN STORAGE 
Explanation: The allocated virtual 


storage 15 too small. 


System Action: Device Support 
Facilities processing continues with 
the next command. 
Cperator Response: None. 
Programmer Response: Increase the 


allocated size of virtual storage, and 
reissue the command. 


Problem Determination: Table I, items 


1, 2» 3» and 29. 


ICK30008I FUNCTION NOT SUPPORTED IN 
THIS ENVIRONMENT 
Explanation: The system adapter was 


entered with a request to perform a 
command not supported in the current 
operating system environment. Probable 
program error. 


System Action: Device Support 
Facilities processing continues with 
the next command. 
Orerator Response: None. 

Programmer Response: The version of 
Device Support Facilities is not 
appropriate for the operating system 
environment. Ensure that the 
appropriate version is installed. 
Problem Determination: Table I, items 
1, 2, 3, %, and 29. 


ICK30200I TOS MANY POSITIONAL 
PARAMETERS AFTER XxXxXxX 
Explanation: <A parameter list has too 


many positional parameters specified, 
specifically those following the 
characters Xxxx. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Pragrammer Response: Ramove the 
excess parameters from the command, 
and reissue the command. 


Problem Determination: 
2, 4, and 29. 


Table I, items 


ICK3SO02ZO1I CONSTANT xxxx EXCEEDS 
LENGTH LIMIT 
Explanation: The constant xxxx 


contains more characters than the 
maximum permitted by the command 


syntax. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 


Programmer Response: Correct the 
constant, and reissue the command. 


Problem Determination: 
2? q, and 29. 


Table I, items 
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ICKZ0202I ABOVE TEXT BYPASSED UNTIL 
NEXT COMMAND. CONDITION 


CODE IS l2. 


Explanation: A syntax error has been 
encountered: the remainder of the 
command is ignored. Messages printed 
just prior to this message indicate 
the nature of the error. 


System Action: The command 
tarminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Proarammer Response: Correct the 
syntax error, and reissue the command. 


Problem Determination: 
<> G, and 29. 


Table I, items 


ICKS02ZO3I ITEM xxxx DOES NOT ADHERE 
TO RESTRICTIONS 


Explanation: An indicated parameter 
does not conform to the naming 
conventions required. For example, 
dname may be misspelled. : 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Correct the 


parameter error, and reissue the 
command. 


Problem Determination: 
2, *, and 29. 


Table I, items 


ICKS0205I BPELIMITER xxxx IS NOT 
FROPERLY PRECEDED BY A 
CGHSTANT GR KEYWORD 

Explanation: A delimiter was found 


where a subparameter list or data was 
expected. The delimiter is improperly 
used: Parentheses may be improperly 
positioned, or a positional parameter 
may be missing. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: Correct the 
syntax error, and reissue the command. 


Problem Determination: 
> 4, and 29. 


Table I, items 
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ICK30207I REMAINDER OF COMMAND INPUT 
STREAN IGNORED 


Explanation: An error has occurred 

which prohibits further scanning of 

the command stream. Messages printed 
just prior to this message indicate 

the nature of the error. 


Note: The condition code (MAXCC) is 
always set to 16 when this situation 
is encountered. 


System Action: Device Support 
Facilities terminates. 
Operator Response: None. 
Programmer Response: Correct the 
error, and reissue the command. 
Problem Determination: Table I, items 
> > and 29. 


ICK3S0208I LEFT PARENTHESIS MISSING 
FOLLOWING KEYNOGRD XXXxX 


Explanation: The keyword xxxx is not 
followed by an opening parenthesis, 
which should begin the required 
subparameter list or value associated 
With the command keyword. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Prograimnmar Response: Check the 
requirements of the keyword, correct 
the syntax, and reissue the command. 


Problem Determination: 
2» &, and 29. 


Table I, items 


ICK302091 RIGHT PARENTHESIS MISSING 
AFTER XXxXX 
Explanation: A closing parenthesis 


was not found where expected, or a 
subparameter list was not properly 
delimited. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Correct the 
command syntax, and reissue the 
command. 

Problem Determination: Table I, items 
2, 4, and 29. 
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ICK302Z210I INVALID PARENTHESES FOk 
SPECIFYING REPEATED 


SUBPARAMETER LIST 


Explanation: Parentheses that are 
used for delimiting repeated 
subparameter Lists are missing or not 
matched. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Gperator Response: None. 
Programmer Response: Correct the 


command syntax, and reissue the 
command. 


Problem Betermination: 
2% G, and 29. 


Table I, items 


ICK30211I KEYWORD xxxx IS IMPROPER 
Explanation: A misspelled, improperly 
specified, or inarplicable keyword was 
encountered in the command. 


System Action: Tha command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax, and reissue the 
command. 

Problem Determination: Table I, items 
2% & » and 29. 


ICK20212I INVALID LEFT PARENTHESIS 
AFTER xXXMX 
Explanation: An opening parenthesis 


was found which appeared to delimit 
the positional parameter xxxx, but the 
positional parameter was not a 
constant or a list of constants. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Resnense: Correct the 
command syntax, and reissue the 
command. 


Problem Determination: 
a>» %*, and 29. 


Table I, items 


ICK3Z02131 KEYHORD xxxx APPEARS TOO 
OFTEN 
Explanatien: The keyword xxxx has 


appeared too often in the command. A 
parameter list may be incorrectly 
specified. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer ReSponse: Correct the 
command syntax by removing the 
kayword, and reissue the command. 


Problem Determination: 
2> %» and 29. 


Table I, items 


ICK30214I1 HEX OR BINARY CONSTANT 
SPECIFIED IMPROPERLY 
Explanation: A hexadecimal or binary 


constant is not specified in the 
correct format: X'n' or Bin’, 
respectively. 


System Action: The command 
terminates. Devica Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Correct the 
command syntax, and reissue the 
command. 


Problem Determinaticn: 
2> 4, and 29. 


Table I, items 


ICK30216I ABOVE TEXT BYPASSED UNTIL 
NEXT COMMAND 
Explanation: An error was encountered . 


during the syntax check of this 
command, and syntax checking was 
terminated. Messages printed just 
prior to this message tndicate the 
nature of the error. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next. 
command. 

Operator Response: None. 
Programmer Response: Correct the 


command syntax, and reissue the 
command. 


Problem Determination: 
2> G, and 29. 


Table I, items 
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ICK302Z17I PASSWORD IMPROPER AFTER 


XXXX 


Explanation: A password, denoted by a 
slash (47), was encountered where a 
password 1s not allowed. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Remove the 
password from the parameter, and 
reissue the command. 


Problem Determination: 
a% Gs, and 29. 


Table I, items 


ICK30218I TOO MANY REPEATED 
SUBPARANETER LISTS APPEAR 
Explanation: Too many repeated 


subparameter lists appear in the 
command. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Check the 
command syntax, correct the error, 
then reissue the command. 


Problem Determination: 
2» 4 and 29. 


Table I, items 


ICK302Z19I VERB NAME XxXxXxX UNKNOWN 


Explanation: The verb xxxx is not 
recognized as a command. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: Reissue the 
command with the correct command name. 


Problem Determination: Table I, items 


2) 4G, and 29. 
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ICK30220I IMPROPER NUMERIC DIGIT 


FOUND IN XXXX 


Explanation: An invalid character was 
encountered in the constant xxxx. A 
decimal number can only be specified 
With the symbols 0 through 93; a 
hexadecimal number can only be 
specified with the symbols 0 through 9 
and A through F; and a binary number 
can only be specified with the symbols 
0 and il. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
command syntax error, and reissue the 
command. 


Problem Determination: 
2» 4, and 29. 


Table I, items 


ICK30221I CONSTANT xxxx NOT WITHIN 
| VALUE RANGE 
Explanation: The value of the 


constant xxxx 1S outside the range of 
values allowed for the associated 
parameter. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Check the 
command syntax for allowed values, 


correct the error, then reissue the 
command. 


Problem Determination: 
2> 4, and 29. 


Table I, items 


ICK3Z0223I TOO MANY CONSTANTS IN LIST 
BEGINNING AT XxXxXxX 
Explanation: Too many constants were 


specified in the command beginning at 
the characters xxxx. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 
Operator Response: None. 
Programmer Response: Correct the 


command syntax, and reissue the 
command. 


Problem Determination: 


Table I, items 
Zs 4, and 29. . 
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ICK302@25I REQUIRED (SUB )PARAMETER OF 
XXXX IS MISSING 


Explanation: aA required parameter or 
subparameter, identified by xxxx, 15 
missing. — 


System Action: The command 
terminates. Device Support Facilities. 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Add the missing 
parameter, and reissue the command. 
Problem Determination: Table I, items 
2, 4, and 29. 


ICK30226I INCONSISTENT PARAMETERS 
IHVOLVING xXxxx 
Explanation: Some commands contain 


parameters that are defined as 
mutually exclusive. If one parameter 
is specified, the other parameter 15 
not allowed. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. | 
Operator Response: None. 
Programmar Response: Correct the 
command syntax, and reissue the 
command. 


Problem Determination: 
2> 4, and 29. 


Table I, items 


ICK30300I ERROR OPENING dsname | 
ddname 
Explanation: An error occurred when 


attempting to open the indicated data 
set or volume. See the associated 
message for the cause of the error. 


System Action: See the associated 


message. 
Operator Response: None. 
Programmer Response: See the 


associated message. 


Problem Determination: 
1, 2% 34 4; and 29. 


Table I, items 


ICKSO301I ERROR CLOSING dsname 
Explanation: An error was encountered 
while attempting to close the data 
set. See the associated message for 
the cause of the error. 


System Action: See the associated 


message. 


Operator Response: None. 


Programmer Response: See the 
associated message. 
Problem Determination: Table I, items 
1, 2% 3> G, and 29. 


ICK30302I ACTION ERROR ON dsname 


Explanation: This message identifies 
the name of the data set that was 
processing when the error occurred. 
See associated message for an 
explanation of the error. 


System Action: None. 


Operator Response: None. 
Programmer Response: None. 


Problem Determination: 
1, ae 3» G, and 29. 


Table I, items 


ICK30304I *xXJCL STATEMENT MISSING 


Explanation: The DD statement that 
was identified in the DDNAME parameter 
is missing COS/VS1, OS/VS2). 


System Action: The command 
tarminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Be sure the DD 
statement is in the job stream as 


specified in the command. Check the 
DDNAME for correct spelling. 


Preblem Determination: 
Ly 2s 3% G, and 29. 


Table I, items 


ICK3SO0309I *XRECORD xxxxx NOT WRITTEN. 
3 LENGTH INVALID 
Explanation: The record xxxxx was not 


written for one of the following 
reasons: 


° The record length was greater than 
LRECL of the output data set. 


° The record length was less than 
the LRECL of the output data set 
and RECFM was F (fixed). 


Note: xxxxx is the first five bytes of 
the record in hexadecimal format. 


System Action: Device Support 
Facilities continues processing until 
four such errors occur. After four 
errors, the command continues to 
execute, but no further records are 
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written to the output data set. 
Operator Response: None. 


Programmer Response: Redefine the 
data set with the correct LRECL value. 


Problem Datermination: 
Ay Zs S15 G, and 293. 


Table I, items 


ICK30312—0 *xXSYSTEM UNABLE TO OPEN 
Explanation: The DCBOFLG was not set 
ON following an OPEN SVC COS/VS5), or 
the OPEN system macro failed 
(DOS/VSE). See the associated messages 
for the cause of the error. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 
Operator Response: None. 
Programmer Response: Perform the 
Problem Determination actions. 


Problem Determination: 
Aer 2» 3, G, and 23. 


Table I, items 


ICKS0313I xxsynad.text 

Explanation: An I/0 error occurred. 
The contents of the OS/VS Data 
Management Services SYNADAF error 
message are written. 


Systen Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Prodrammar Response: Check the 
explanation of the SYNADAF message. 


Correct the error, and reissue the 
command. 


Problem Determination: 
Ls 2» 33 G, and 29. 


Table I, items 


ICKZO0S315I *XRECORD SIZE GREATER THAN 
32767 NOT SUPPORTED 
Explanation: The system cannot 


process a logical record whose size is 
greater than 32,767 bytes. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. > 

Operator Response: None. 
Programmer Response: Change the DD 
statement to specify a LRECL length 
that is less than 32,767 bytes. 
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Problem Determination: 
l, 2 5 s; G, and 29. 


Table I, items 


ICK30317I *xXPERHANENT I70 ERROR 
Explanation: An error was detected 
While performing an I/0 operation. The 
data set name is given in the 
associatad message. 


System Action: The commard 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Responsa@: None. 

Programmer Response: Check the OS/VS 
JCL statements to be sure the data set 
was correctly defined. If the data set 
Was correctly defined, a hardware 
error was encountered and the data set 
must be re-created on another I/0 
device. 


Problem Determination: 
2> 3, 4% and 29. 


Table I, items 


ICK30318I xXINVALID DATA SET 


SPECIFICATION 


Explanation: In the DOS/VSE 
environment, the I/0 adapter 
open/close routine was unable to open 
a data set because of an invalid 
specification of the data set in the 
DLBL statement. 


System Action: Processing for the 
specific data set 15s terminated. 
Command processing will continue if 
the opening of the specific data set 
15 deemed noncritical to the main 
function performed by the command. 
Operator Response: None. 
Programmer Response: Probable user 
error. Check the DLBL statement. If 
there are no errors, contact your 
system programmer. 


ICK30320I *xXINVALID DEVICETYPE 


Explanation: In the DOS/VSE 
environment, the I/0 adapter 
open/close routine was unable to open 
a data set, because it exists on a 
device that 1s not supported for 
sequential processing. 


System Action: Processing for the 
specific data set is terminated, and 
the command processing Will continue 
if the opening of the specific data 
set is deemed noncritical to the main 
function performed by the command. 


Operator Response: None. 
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Programmer Response: Probable user 
error. The data set does not exist on 
a valid device that is supported for 
sequential processing (SAM access _ 
method). Correct the situation, and 
resubmit the job. If the error 
persists, contact your system 
programmer. 


ICK30321I **XOPEN/CLOSE ABEND EXIT 
TAKEN 
Explanation: The OPEN/CLOSE System 


Services SVC detected an error when 
opening or closing a data set. The 
ABEND message was written to the 
JOBJCL data set. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the ces 
command. 


None. 
Programmer Response: Check the ABEND 


message, correct the error, then 
reissue the command. 


Qperator Response: 


Problem Determination: 
Ls ae S53 a, and 23. 


Table I, items 


ICK3O500I MAIN STORAGE NOT AVAILABLE, 
COMMAND TERMINATED 
Explanation: Dynamic acquisition of 


storage for control blocks and work 
areas failed 


System Action: The command is 


tarminated. 


Cpearator Response: Increase main 
storage size, and resubmit the job. 


Problem Determination: 


Table I, items 
Ls 2 3s Gs: and 29 . 


EQUIPMENT CHECK ON cuu 
An EQUIPMENT CHECK I70 


ICK307011 


Explanation: 
error occurred. 


System Action: Execution of the 
command is terminated. 


Orerator Response: None. 


Pregrammer Response: 
Determination. 


See Problem 


Problem Determination: Table I, items 


1, 2, 3, 4, and 30. 


ICK30702I OPERATOR DID NOT READY 
DEVICE 

Explanation: When the operator was 
prompted by message ICK004D to make a 
device ready, the response was to 
terminate the command. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Crerator Response: None. 
Programmer Response: None. 


Problem Determination: Table I, items 


1, 23 Sy 4G, and 29. 


ICK307031 


Explanation: The device referenced in 
the ICKDSF command by the UNITADDRESS 
or DDNAME parameter is already being 
used by another job. 


DEVICE ALREADY IN USE 


System Action: The device referenced 
in the ICKDSF command by the 
UNITADDRESS or DDNAME parameter is 
already being used by another job. 


Operator Response: None. 


Programmer Response: None. 


Problem Determination: 


Table I, items 
l, ar» 3+ 4> and 29. 


1CK307062 


INVALID DEVICE-TYPE FOR 
FUNCTION 
Explanation: The type of device 


specified is invalid for the command 
issued. For instance, a Mass Storage 
System staging pack cannot be a 2314 
davice. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: Reissue the 
command, and specify an appropriate 


device. 


Problem Determination: Table I, items 


1, 2, 3, 4, and 29. 
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ICK30705I OPERATOR DID NOT SET DEVICE 


TO RRITE-MODE 


Explanation: During I/0 operations, 
the device was found set for read-only 
moda. The operator elected to 
terminate the command in response toa 
message ICK014D instead of satting the 
device to write mode. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 

Programmar Response: Ensure that the 
device i535 in Write mode, and resubmit 
the command. 


Problem Ostermination: 
by: (2%. 3s -4& Sena 29. 


Table I, items 


ICKSO7Q06I DEVICETYPE PARANETER 
MISSING OR ERRONECUS 
Explanation: This message appears 


only in a stand-ewlone environment. The 
DEVLCETYPE parameter must specify one 
of the valid device types. See 

Figure 2 on page 4 for valid device 
types. 


System Action: The command 
tarminates. Device Support Facilities 
processing continues with the next 
command. 


Orerator Response: None. 


Pregrammear Response: Correct the 
error, and reissue the command. 


Problem Batarminatioan: 
25 S5 Gs and 29. 


Table I, items 


ICKSO7G7I MIMIC NINIZENY 
SPECIFICATIGN ERRGRNRECUS 
Explanation: The number of cylinders 


specified, either for an QS/V5 
minidisk for the VM/370 anvironment or 
for an emulated Count Key Device ona 
fixed block device, i5 g' eater than 
the total number of prinacy cylinders 
that exist on tre volume. 


System Action: The command terminates 
and Davice Suppert Facilities 
continues proecassing with the next 
command. 


Cnperator Response: None. 
Praarammer Response? Correct the 
invalid number of cylinders in the 


MINI or EMU specification, and 
resubmit the job. 
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ICKSO7O8I | DEVICETYPE PARAMETER 
-REQUIRED WITH MIMIC MINT 
SPECIFICATION. 

Explanation: When vou specify the 


MIMIC MINI parameter, you must also 
specify the DEVICETYPE parameter. 


System Action: The command terminates 
and Device Support Facilities 
continues processing with the next 
command. 


Crerator Response: None. 


Programmer Response: 
command syntax, 


Correct the 
and resubmit the job. 


ICK307@092 ACCESS DENIED TO SHARED 
DEVICE cuu BY QPERATOR 
Explanation: If the operator replies 


T to message ICK008D, this message 
appears before termination of the 
command. 


System Action: Command processing 
terminates, and Device Support 
Facilities continues processing with 
the next command. 


Operator Response: None. 


Programmer Response: Resubmit the job 
when the volume is accessible. 


GTCK38711I CHANNEL ERROR: 


CSWEXXXXXX XXXXXXXX 


Explanation: An unrecoverable channel 
error occurred. xx . XX 315 a 
hexadecimal display of the last saven 
bytes of the CSW at the time of the 
error. 


System Action: Execution of tha 
cemmand is terminated. Device Support 
Facilities processing continues with 
the next command. 


Operator Response: None. 


Programmner Response: See Problem 


Datermination. 


Problem Determination: 
1; 2» a5 Gq, 


Table 1, items 


ICKS0712I xxx DEVICE TYPE 


VERIFICATION FAILED 


Explanation: During OPEN, ICKDSF was 
unable to determine the device type at 
address xxx, or the device typa 15 not 
supported. If the sense ID CCW X'E4! 
is supported by the device at address 
XxX, then the following message is 
15sued: 
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PHYSICAL DEVICE=UNKNOWN 
SENSE ID=xxxxxxxXxXXXXXXX 


See the appropriate device manual for 


the sense ID information. Basically, 
the format is as follows: 

byte 0 = X'FF! 

byte 1-3 = control unit id 

bytes 4-6 = device id 


If the sense ID CCN is not supported 
by the device, the following massage 
is issued: 


PHYSICAL DEVICE=UNKNOWN 
LOGICAL DEVICE=UNKNOWN 


System Action: 
command 1S 


Execution of the 
terminated. 

Operator Response: None. 

Programmer Response: The direct _ 
access devices supported by ICKDSF are 
listed in the Intreduction. Check that 
the device specified by the 
UNITADDRESS, DDNAME, or SYSNAME 
parameter is supported by ICKDSF. If 
the device is supported by ICKDSF, 
follow the problem determination 
Shown. 


Problem Determination: Table I, items 
1, 2, 3, 4, 13, 
ICK31004I VTOC CREATION FAILED 


Explanation: An I/0 error occurred 
when attempting to writa a volume 
table of contents on the volume. 


System Action: The volume table of 
contents is not written on the volume, 
and the command terminates. Device 
Support Facilities processing 
continues with the next command. 
Orerator Response: None. 
Programmer Response: 
Determination. 


See Problem 


Problem Determination: 
l; a 3s 4, and 23. 


Table I, itams 


ICK31006I VOLUME LABEL CREATION 
| FAILED 


Le 


Explanation: An I70 error occurred | 
when attempting to write a volume 
label. 


System Action: <A volume label was not 
written, and the command terminates. 
Device Support Facilities processing 
continues with the next command. 


Operator Response: None. 
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Programmer Response: See Problem 
Determination. | 


Problem Determination: Table l, 2, 3, 


4, and 29 

ICK31007I ALLTRACKS NOPRESERVE NOT 
SUPPORTED USE THE 
INITIALIZE COMMAND 

Explanation: ALLTRACKS NCPRESERVE 


destroys a volume, including the VTOC 
and the volume label. This function is 
not supported. 


System Action: The coinmand 
terminates. Davice Support Facilities 
processing continues with the next 
command. 

Cperator Response: None. 
Programmer Response: Usa the INIT 
command. If NOQOCHECK was specified, 
use a medial INIT. If CHECK was 
specified, use a minimal INIT. 
Problem Determination: Not 
applicable. 


ICK31012I VOLID NOT SPECIFIED AND NO 
VOLUME LABEL EXISTS 
Explanation: A volume being 


initialized must either contain a 
volume label from which the old volume 
serial can be used, or the VOLID 
parameter must specify a new volume 
serial number. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Be sure that the 
correct volume is mounted, or spacify 
the VOLID parameter, and reissue the 
command. 


Problem Determination: Table I, items 
1, 2, 3» 4%» and 29 
UNRECOVERABLE TRACK 


ICK310132 | 
| THRESHOLD MET 


Explanation: The 
installation-specified threshold of 
unrecoverable tracks, sat to ten by 
default, has been met. CAn | 
unrecoverable track is one that cannot 
be repaired by software: it is 


neither readable nor writable by the 


drive.) 


System Action: The command terminates 
to prevent further damage to the disk 
pack. Device Support Facilities 
processing continues with the next 
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command. 


Orerator Response: None. 

Programmer Response: See Problem 
Determination, and notify the customer 
engineer. 


Problem Determination: 
1 2%. 33° Se cand 30. 


Table I, items 


ICK31015I UNABLE TO READ VOLUME LABEL 
Explanation: An I/0 error occurred 
when attempting to read the volume 
label to verify the volume serial 
number. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Qrerator Response: None. 

Programmer Resnonse: Reissue the 
command and specify the NOVERIFY 
parameter, or reinitialize the volume. 


Problem Determination: 
t, ae Sy Gy, and 29. 


Table I, items 


ICKZ1019I NEXT-AVAILABLE~ALTERNATE 
POINTER OR COUNTER IN vToC 
IS INVALID 

Explanation: The value of the pointer 


to the next available alternate track 
or the count of the number of 
alternate tracks that are available is 
In error. 


System Action: Processing continues. 
If it is possible, the value in the 
¥TOC is updated when processing 
completes. 
Cperator Response: None. 

Programmer Response: Reinitialize the 
volume at either the minimal or the 
maximal level. 


Problem Determination: 
1, ae Sy 4G, and 29. 


Table I, items 


ICK31022I UNABLE TO CHANGE VOLUME 
LABEL 
Explanation: An I/0 error occurred 


while attempting to change the volume 
serial number, the owner | 
identification, or the address of the 
sift table of contents in the volume 
abel. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. : 
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Operator Response: None. 


Programmer Response: Reinitialize the 


volume. 


Problem Determination: 
ly 23. 3%. 4% and 29. 


Table I, items 


ICK310231 INVALID UNITADDRESS, | 
SYSNAME OR DDNANE SPECIFIED 
Explanation: The channel and unit 


addresses specified do not exist in 
the system I/0 configuration, or the 
DDNAME is incorrect, or the SYSNARME 15 
incorrect. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Correct the 
value substituted for cuu, or for 
dname, or for sysxxx, then reissue the 
conmand. 


Problem Determination: 


Table I, items 
es a» a3 4G, and 23%, 


ICK310246I UNABLE TO OPEN VOLUME 
Explanation: The volume that was 
specified cannot be opened. The DD 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 
Cnherator Response: None. 
Progremmer Response: Correct the 
error, and reissue the command. 


Problem Determination: 
Ly 23 s; 4G, and 293. 


Table I, items 


ICK31025I VOLUME NOT MOUNTED PRIVATE 
Explanation: When online 
initializing, inspecting, or 
reformatting is requested, the 
specified volume must be mounted 
PRIVATE to prevent interference by 
other jobs. 


System Action: The command 
tarminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 
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ammer Response: Be sure the 
e is mounted PRIVATE, or perform 
ob offline. 


lem Determinations: 


j Table I, items 
a?) 4, and 29. 


10267 COMMAND INVALID FOR 
"UNINITIALIZED VOLUME 


sivnatton: The INSPECT and REFORMAT 
vands can only be specified for a 
‘Fously initialized volume. 


ystem Action: The command 
erminates. Device Support Facilities 
Cessing continues with the next 
mman cd. 


erator Response: None. 


regranmer Response: Initialize the 


ebten, Determination: 
> 3» 4, and 29. 


Table I, items 


310271 UNABLE TO WRITE VOLUME 


LABEL DURING VTOC CREATION 


fanation: An I/0 error occurred 

y attempting to rewrite the volume 
1 field that locates the volume 
of contents. 


The command 

: Device Support Facilities 
an ocessing continues with the next 
command. 


fam Action: 
‘inates. 


- Gperator Response: None. 


Programmer Response See Problem 
Determination. 
Problem Determination: 


COMBINATION OF ASSIGN AND 
ALLTRACKS AND NOCHECK 
PROHIBITED 


CK3103461 


“oo apepilanation:. This combination of 
‘parameters is prohibited, because 
. there are fewer alternate tracks than 
oo primary tracks on the volume. This 
_ ‘Sombination of parameters specifies 
oi unconditional assignment of alternate 
—  Sracks for all the primary tracks. 


System Action: The command 
rminates. Device Support Facilities 
ecessing continues with the next 


tor Response: None. 


swammer Response: Change the 
‘nation of parameters, and reissue 
“command. 


Table I, items 


Problem Determination: 
1; 2> 35 G, and 23. 


Table I, items 


ICK31035I UNABLE TO READ FORMAT-4 
DSCB 


Explanation: An I/O error occurred 
when attempting to read the format-4 
data set control block C(DSCB) for the 
volume table of contents. This record 
is read, then rewritten, to indicate 
the location. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 


Programmer Response: 
volume. 


Reinitialize the 


Problem Determination: 
1, Zs 35 G, and 23. 


Table I, items 


ICK31036I UNABLE TO INITIALIZE 2314 
MINI DISK 
Explanation: For the 2314 minidisk 


specification, initialization of less 
than 2 cylinders was requested. This 
is not acceptable because one cylinder 
is always used as a cylinder of 
alternate tracks. 


System Action: The command 
terminates. Device Support Pact ties 
processing continues with the next 
command. 


Operator Response: None. 
Programmer Response: Correct the 


MIMICCMINICn) parameter and reissue 
the command. 


ICK31038I NO VALID TRACKS WERE 
SPECIFIED 
Explanation: If the TRACKS parameter 


specifies only invalid track 
addresses, this message indicates that 
the command was not processed. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 

Programmer Response: Reissue the 
command, and specify one or more valid 
track addresses. 


Problem Determination: 
1, 2» 35 4, and 29. 


Table I, items 
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ICK31043I NO STORAGE AVAILABLE TO 
HCLD RECORD BEING 
PRESERVED, TRACK 


CCOHH=X'ccece hhhh* 


Explanation: To preserve the contents 
of a track during surface checking, 
the complete track is read into a 
dynamically allocated buffer in 
accordance with the track capacity of 
the volume. There is insufficient 
space in Which to allocate this 
buffer. 


System Action: The track under 
inspection is not surface checked to 
avoid loss of data, and the command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Increase the 
available storage space, or specify 
the NOPRESERVE parameter if the data 
may be destroyed, then reissue the 
command. 


Problem Determination: 
i as Ss G, and 293. 


Table I, items 


ICK31046I UNABLE TO WRITE FORMAT-4 
DSCB AT CCHH=X'cccc hhhh*'t 
Explanation: An I/O error occurred 


when attempting to update the volume 
table of contents. The address of the 
first available alternate track and 
the number of alternate tracks could 
not be written in the VTOC. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Reinitialize the 
volume and specify a different 
cylinder and track location for the 
volume table of contents, or issue the 


INSPECT command to assign an alternate 
track. , 


Problem Determination: 
1, 2s S% 4G, and 29. 


Table I, items 


ICK31049I UNITADDRESS SPECIFIED FOR 
VOLUME MOUNTED ON-LINE 
Explanation: The UNITADDRESS 


parameter is valid for offline 
processing only, but this device was 
mounted online. 
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System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Cperator Response: None. 

Programmer Response: Mount the volume 
offline, or specify the DDNAME 
parameter. 


Problem Determination: 
Ls 2» 3> G, and 29. 


Table I, items 


ICK310S2I MINIMAL INITIALIZATION NOT 
PERMITTED FOR MSS STAGING 
PACK, | 

Explanation: To initialize a pack as 


a Mass Storage System staging pack, 
the VALIDATE or the CHECK parameter 
must be specified to initialize the 
pack at medial or maximal level, 
respectively. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Reissue the 
command with the VALIDATE parameter 
specified. 


Problem Determination: 
1, 2, 3, 4, and 29. 


Table I, items 


ICK31054I DEVICE NOT SUPPORTED FOR 
THE SPECIFIED FUNCTION 
Explanation: The volume that was 


specified for the command 1s not 
supported for the function as defined 
by the combination of parameters used. 
For example, ANALYZE is not valid for 
a 2314 device. See Figure 2 on page 4 
for other incompatible functions. 


System Action: Processing of the 
command 1s terminated. 


Operator Response: None. 
Programmer Response: Correct the 
control statement, and reissue the 
command. 


ICK31056I VTOC LOCATION IN VOLUME 
LABEL INCORRECT 
Explanation: The VTOC location 


specified in the standard volume label 
1S incorrect. Therefore, 
addressability to the volume table of 
contents is lost. 
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System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Cperator Response: None. 

Programmer Response: Reinitialize the 
volume, and reestablish addressability 
to the volume table of contents. 


ICK31057I INVALID DEVICE TYPE: vTOC 
INDEX NOT SUPPORTED GN THIS 


DEVICE 


Explanation: The device type is not a 
valid device type for initialization 
With a VTOC index. 


System Action: The creation of the 
VTOC index is not attempted. INIT 
command processing continues. 
Operator Response: None. 


Programmer Response: None. 


ICKS1LO58I cuu I/0 ERROR DETECTED 
DURING INDEX CREATION: 
ERROR CODE= x 

Explanation: An I/0 error occurred 


during VTOC index creation processing. 
Frror codes: 


1 - Error occurred in reading the 
volume label 


2 - Error occurred in reading the 
VTOC 
3 ~- Error occurred in writing the 
— V¥TCC ; 
4 - Error occurred in writing 
Index records | 
5 - Index extent was violated; 


increase index size 


System Action: VTOC index creation 
processing 18 terminated. The DOS | 
volume indicator 1s turned on in the 
VTOC. INIT command processing 
continues. 


Operator Response: Refer the error 
indication to the system coordinator 
for Problem Determination. 

None. 


Table I, items 


Programmer Response: 


Problem Datermination: 
1, 25 3» 4, 29. 


ICK31059I INDEX STARTING LOCATION 
INVALID AS SPECIFIED 
Explanation: The INDEX parameter on 


the INIT command statement is invalid. 
The starting location, as specified, 
is not valid for one of the following 
reasons: 


System Action: 


° It caused an overlap with the VTOC 


e It defined cylinder 0, track 0 as 
the starting location of the index 
data set 


° It was outside the physical limits 
of the device 


e The relative track specified is 
invalid for the device 


Execution of the 
command is terminated. 

Operator Response: None. 

Programmer Response: Check the values 
specified for the INDEX parameter, and 


correct the value in error. Resubmit 
the job. 


ICK31061I cuu VTOC INDEX CREATION 
SUCCESSFUL: VOLUME NOW IN 


INDEX FORMAT 


Explanation: The VTOC index was 

successfully created on the volume. 
System Action: None. 
Operator Response: None. 


Programmer Response: None. 


ICK31062I cuu VTOC INDEX CREATION 
FAILED: RETURN CODE= 8 
Explanation: Index creation was 


unsuccessful. 
System Action: None. 

None. 
Programmer Response: Check the job 


cutput for additional information on 
the reason for job failure. 


Operator Response: 


ICK31063I UNABLE TO READ HOME ADDRESS 
BEFORE DATA SAVED FROM 
CCHH=xX"cccc hhhh' 

Explanation: Before the data ona 


track can be read, the home-address 15 
read from the specified track. This 
read operation failed. For this 
specific case, the command processing 
terminates. In every other case, that 
is, where data is not preserved 
CNOPRESERVE specified), an attempt is 
made to recover the home-address, but 
recovery generally involves erasure of 
the rest of the track. 


System Action: Execution of the 
command is terminated. 


Opsrator Response: None. 
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Programmer Response: Attempt to 
recover the data on the track; if 
successful, reissue the command with 
the NOPRESERVE option. An attempt will 
be made to recover the home-address. 


ICK31066I UNABLE TO READ RECORD ZERO 
BEFORE DATA SAVED FROM 
CCHH=X'cece hhhh’ 

Explanation: Before the data ona 


track can be read, the record 0 is 
read from the specified track. This 
read operation failed. For this 
specific case, the command processing 
terminates. In every other case, an 
attempt will be made to recover the 
record 0, but recovery generally 
involves erasure of the rest of the 
track. : 


System Action: Execution of the 
command 15 terminated. 

Operator Response: None. 

Programmer Response: Attempt to 
recover the data on the track; if 
successful, reissue the command with 
the NOPRESERVE option. An attempt will 
be made to recover the record 0. 


ICKSLI300I VERIFICATION FAILED: 
VOLUME-SERIAL WRONG 
Explanation: The VERIFY parameter was 


specified and the specified volume 
serial number does not match the 
volume serial number found in the 
volume label. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 
Cperator Response: None. 

Programmer Response: Ensure that the 
correct volume is mounted, correct the 
volume serial number specified in the 
command, or specify the NOVERIFY 
parameter. 


Problem Determination: 
l; oj 33 G, and 29. 


Table I, items 


ICK313011 VERIFICATION FAILED: 
OWNER-ID WRONG 


Explanation: The VERIFY parameter was 
specified, and the specified owner 
identification does not match the 
owner identification found in the 
volume label. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 

Programmer Response: Ensure that the 
correct volume is mounted, correct the 
owner identification specified in the 
command, or specify the NOVERIFY 
parameter. 
Problem Determination: Table I, items 
l; oe 3» G > and 29. 


ICK31303I UNABLE TO VERIFY 
AUTHORIZATION FOR PROTECTED 
DATA SET 

Explanation: At attempt was made to 


scratch a data set, but the user was 
not authorized to do so. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Obtain the 
proper authorization, or reissue the 
command in the offline mode. 

Problem Determination: Table I, items 
1, 2» Sy G, and 29-3 


ICK31304¢I SYSTEM OPERATOR DID NOT 
CONFIRH DATA SET PURGING 
Explanation: The operator replied T 


to message ICKOOILD. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Determine if the 
data may be purged and, if so, reissue 


the command and reply U to message 
ICKOOLD. 


Problem Determination: 
1, 2, 3,» 4%» and 29. 


Table I, items 


ICK3S1305I UNEXPIRED OR PASSNORD 
PROTECTED DATA SET FOUND ON 
VOLUME 

Explanation: When attempting to 


initialize a volume online with the 
NOPURGE parameter specified, unexpired 
data sets or password-protected data 
sets were found that prevent 
initialization of the volume. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Appendix C. Device Support Facilities Messages (ICK) 139 


Operator Response: None. 


Programmer Response: If the unexpired 
data sets may be purged, reissue the 
command and specify the PURGE 
parameter, or process the volume 
offline. 


Problem Determination: 


Table I, items 
1, o> 3, 4, and 29 


ICK31224I VOLUME CONTAINS VSAM DATA 
SET(S) 
Explanation: The volume being 


processed online contains one or more 
VSAM data sets. 


System Action: The data sets are not 
destroyed, and the command terminates. 
Device Support Facilities processing 
continues with the next command. 


Operator Response: None. 


Programmer Response: Use Access 
Method Services to delete the VSAM 
data sets, or initialize the volume 
offline. 


Problem Determination: 


Table I, items 
1, 2» Sy 4G, and 29. | 


TCKS1325I OPERATOR REFUSED PURGE 


PERMISSION 


Explanation: The operator responded T 
to massage ICKO03D. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command 


Operator Response: None. 
Programmer Response: Determine why 
the request to process was refused, 
and reissue the command. 


Problem Determination: None. 


ICK31326I IMPROPER RACF ACCESS 
AUTHORITY 
Explanation: A volume that is RACF 


protected cannot be processed unless 
the user has the proper level of 
authorization. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Obtain the 
proper level of authorization, or 
process the volume in offline mode. 


Problem Determination: Table I, items 


1, 2, 3, 4, and 29 


NO STORAGE AVAILABLE FOR 


ICK313271 
| MAXIMUM TRACK CAPACITY 
RECORD 
Explanation: No storage was available 


to build the bit pattern in a main 
storage buffer that would eventually 
be written on the volume during 
surface check. 


System Action: The command 
terminates. Device Support Facilities 
continues with the next command. 
Operator Response: None. 

Programmer Response: Specify a larger 


region size for the job step, and 
resubmit the job. 


SURFACE ANALYSIS CYLINDER 


ICK313291 
COULD NOT BE READ 
Explanation: For the 3375 or 3380, an 


error occurred accessing the surface 
analysis cylinder. Skip displacement 
information could not be recovered. 


System Action: The current track is 
flagged not recoverable. Device 
Support Facilities continues 
processing on the next track. 


Crperator Response: None. 
Programmer Response: See Problem 
Determination. 

Problem Determination: Table I, items 
1, 2s 3% Gs 30. ‘ 


ICK31401I cuu SUSPECTED DRIVE PROBLEM 
Explanation: During the drive tests, 
ANALYZE detected an error. During the 
data verification test, ANALYZE 
detected an error other than a data 
check. 


System Action: ANALYZE processing 
terminates, and message ICK406I 
CICKO014061I) is issued. 


Operator Response: Depending on your 
installation's procedures, you might 
do the following: 


_ Restore the entire volume to 
another drive from a backup 
volume. 

° Discontinue using the drive. 


Save the console output and ANALYZE's 
printer output, which contain further 
information about the hardware 
problems. 


140 Device Support Facilities User's Guide and Reference 


Take the action appropriate to your 
installation's procedures for handling 
suspected equipment problems. If the 
problem recurs, contact your IBM 
Customer Engineer or Service 
Representative. 


Problem Determination: 
i, 2, 3, 4%, 30 


Table I, items 


TCK3S1¢6¢02I cuu ERROR READING DATA 
Explanation: ANALYZE detected data 
ehecks while reading data. This 
message is followed on the printer by 
a message that identifies the track 
and cylinder number on which each data 
check occurred. The cause of the 
problem could bea a damaged disk 
surface or an intermittent read/write 
circuitry failure. 


System Action: ANALYZE processing 
terminates, and message ICK406I 
CICK0146061) i858 issued. 


Operator Response: Depending on your 
installation'ts procedures, you might 
do one of the following: 


° Restore the entire volume from a 
backup volume. 


e Rebuild the track that has the 
error. 


© Assign an alternate track arid then 
restore the track. 


e Rebuild the data set. 
Save the console output and ANALYZE's 


printer output, which contain further 
information. 


ICK3S1403I cuu DATA SCAN VALUES : 
INVALID, testing terminated 
Explanation: The relative block 


number(s), tracks, or cylinders 
specified by the LIMITS parameter are 
invalid. 


System Action: 
net done. 


Data verification 15 


Crerator Response: Specify valid 
relative block number(s), tracks, or 
cylinders in the LIMITS parameter, and 
resubmit the request. 


ICK31404I cuu VOLUME HAS UNFORMATTED 
DATA BLOCKS 
Explanation: An attempt was made to 


read a data block which was not 
initialized (data field not written). 


System Action: After 504 data checks, 
the ANALYZE command is terminated. 
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Qnerator Response: Perform 
appropriate procedures to recover all 
desired data from the volume and then: 


run the DOS utilities INTDK or INTDSK 
with the fI@' option to initialize all” 


data blocks. 


MAIN STORAGE NOT AVAILABLE, 


ICK31410I1 
TESTING TERMINATED 
Explanation: Dynamic acquisition of 


storage for work areas and control 
blocks failed. 


System Action: ANALYZE command 
processing 1s terminated. 


Operator Response: Increase main 


storage size. 


ICK31411I INCORRECT DEVICE TYPE, 
TESTING TERMINATED 
Explanation: The devices type 


specified for the ANALYZE volume 15 
not supported by ANALYZE. 


System Action: 


ANALYZE processing 1s. 
terminated. 


Operator Response: See Figure 2 on | 
nage 4 for valid device types. ae: 


ICK314122 DEVICE NOT READY, TESTING | 
TERMINATED — 


that caused "Intervention Required” to 
be posted in the failing CSW sense 
byte. | ae 


System Action: The ANALYZE command is 
terminated. ke 
Operator Response: Ready the drive, — 

and reissue the command. 


ICK31413I DATA FORMAT UNACCEPTABLE, 
TESTING TERMINATED | 


Explanation: Data on the cylinder is 


written in a format other than the IBM 
standard format, or an intermittent = | 
drive error occurred during the data | 
verification test, or the volume under — 


test was accessed by another program. 


that erased an EOD record after it. ae 
read by the data verification test and 


before it was reread by the test. 


System Action: 
terminated. 


Operator Response: None. 


ICKS1505I cuu VTOC FORMAT IS 


REJECTED 


ANALYZE erscessvag is 


CURRENTLY XXFORMAT, REQUEST = 


Explanation: The format of the VTOC 4, Le 


is currently the same as the format Indicate logical errors 

requested in the BUILDIX command | 

statement. '**' identifies the format Bg | 

of the VTOC, either OS or IX. Indicates an invalid index 
structure 


System Action: Execution of the 
command is terminated. | 16 


Indicates an I/0 error 
Crerator Response: None. 
The error condition will be printed 


Programmer Response: Check the only for a return code of 4 or 8. See 
command statement. The format Appendix B of Data Facility Device 
requested must be opposite from the. Support: User's Guide and Reference 
current VTOCC format as identified in for more information on these error 
this message. Be certain that the JCL conditions. 

DD statement correctly identifies the 

volume. Change the statement (s) where System Action: Execution of the 
required, and resubmit the job. command terminates with the following 


conditions existing, depending on the 
return code: 
ICK31509I cuu DIRF FLAG SET IN VTOC, 


BUILDIX CANNOT PROCEED 4, 8 12 
| | The volume is left in OSVTOC | 
Explanation: An error occurred during format. 


VTOC processing on a previous job, 
causing the DADSM interrupt flag to be 16 


set in the VTOQC. The VTOC is not The volume is left as it was 
accurate. before the command was issued. 
System Action: Execution of the Cperator Response: None. 


command is terminated. | 
| Programmer Response: Refer to the 


Onerator Response: Prepare a job that DADSM program logic manual for a full 
Will cause reconstruction of the VTOC, explanation of CVAF return codes and 


and run it against the volume. (For error condition codes. 
example, run an ITEFBRI4 job to * 

allocate a temporary data set to the | 

volume.) On conclusion of this job, ICK31512I cuu ERROR: SYS1.VTOCIX. IS 


resubmit the BUILDIX command. A VIO DATASET. BUILDIX 
| TERMINATED. 


Programmer Response: None. . 

Explanation: The index data set was 
| allocated as a VIO data set and is not 
ICKSi51024 cuu BUILDIX REQUEST supported by the BUILDIX command. 


CANCELLED BUE TO OPERATOR 
ACTION System Action: Execution of the 
command terminates with a return code 
Explanation: The operator replied of 12. The VTOC is left unchanged. 
*CANCEL' to a massage requiring a 
response. Operator Response: None. 
System Action: Execution of the Programmer Response: Ensure that 
command 15 terminated. allocation of the index data set 
! specifies a permanent data set. Check 
Operator Response: None. the JCL statament that defines the 
index data set and change the 
Procrammar Response: Check with the parameter. Resubmit the job. 


operator for the reason for 
cancellation of the job. 

: ICKS1S14I INDEXED VTOC FACILITY NOT 
| ON SYSTEM. BUILDIX | 
ICK3SI511I cuu CVAF ERROR: RETURN TERMINATED. 


COBDE=** ERRGR CONDITION= 
KKK Explanation: A request was made to 
change a VTOC to IXVTOC format, but 

Explanation: The common VTOC access the system does not contain indexed 
facility returned to Device Support. VTOC programming support. 7 
Facilities with a return code | | 
indicating either a logical error or a System Action: Execution of the 
physical error. Return codes have the command is terminated. © 


following meanings: 
3 Operator Response: None. 
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Programmoar Response: None. 


ICK3I515I cuu BUILDIX CCNMAND FAILED. 


RETURN CODE= 8 


Explanation: An error occurred that 
caused execution of the command to be 
terminated. 


System Action: Execution of the 
command 1s terminated. : 


None. 
Pracrammar Rasnonse: Check the job 


output for messages describing the 
type of failure. 


Operator Response: 


ICKSL151$I cuu I70 ERROR DETECTED 
DURING VTOC COUVERSION: 


ERROR CODE= & 


Explanation: An I/0 error occurred 
during BUILDIX processing. Error 
codes: 


1 - Error occurred in reading the 
volume label | 

e -~ Error occurred in reading the 
VTOC 

3 - Error occurred in writing the 
VTOC 

4 - Error occurred in writing 
index records 

5 - Index extent was violated; 


increase index size 


System Action: Execution of the 
BUILDIX command is terminated. 


Coerator Response: Refer the error 
indication to the system coordinator 
for Problem Determination. 


Programmer Resnronse: None. 


ICK3SIS17I cuu ERROR: 
STACKED PACK 


VOLUME IS A DOS 


Explanation: The volume being 
processed has a VTOC on the first 
track of the volume. VTOC conversion 
is not possible on such a volume. 


System Action: Execution of the 
command is terminated, 


Cperator Response: None 


Programmer Response: Correct the 
problem on the volume, possibly by 
initializing the volume with an INIT 
command. Note, however, that this will 
purge all existing data on the volume. 


ICKSI518I° cuu ERROR: VOLUME CONTAINS 


SPLIT CYLINDER EXTENTS 


. Appendix C. 


System Action: 


Explanation: It was found that the 
volume contains one or more shared 
extent data sets. These are not 
supported by the BUILDIX command. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: None. 


Programmer Response: None. 


ICKSIS19I cuu ERROR: SYSI.VTOCIX. 


DATASET NOT FOURD ON VOLUME 


Explanation: The index data set could 
not be found on the volume. 


Execution of the 
BUILDIX command is terminated. 
Operator Response: None. 

Programmer Response: Check the job 
control statements to see if a DD 
statement exists that will cause 
allocation of the index data sat. If 
the statement exists, check if the 
name 1s specified correctly. Correct 
the error and resubmit the job. 


ICK31520I cuu ERROR: BUPLICATE INDEX 
DATASET NAME FOUND ON 
VOLUNE 

Explanation: Two data sets were found 


on the volume that had names beginning 
with SYSi.VTOCIX. Only one is allowed 
per volume. | : 


System Action: Execution of the 
BUILDIX command is terminated. 
Operator Response: None. 

Programmer RESPpsonsas Submit a job to 
scratch one of the data sets, or 


scratch both data sets if new index 
allocation is desired. 


ICK3S1S521I cuu ERROR: INDEX BATASET 
EXTENT NOT CONTIGUOUS 
Explanation: This data set was found 


to occupy more than one extent. The 
index data set must occupy one, and 
only one, extent. 


System Action: Execution of the 
BUILDIX command is terminated. 
Operator Response: None. 

Programmer Response: Scratch the 
invalid index data set, and resubmit 
the job with a job control statement 
that will ensure that only one extent 
is allocated to the index. 
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ICK31522I INVALID DDNAME SPECIFIED 


Explanation: The DDname is incorrect 
in the command statement. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: Correct the job 
control statement, and resubmit the 
job. 


Programmer Response: None. 


ICK31524I UNABLE TO OPEN VOLUME 
Explanation: The volume specified 


cannot be opened. The BD statement 
could be missing or invalid. 


System Action: Execution of the 
BUILDIX command is terminated. 


Operator Response: Correct the error, 
and resubmit the job. 


Programmer Responses None. 


ICK3Z1602I INCORRECT DEVICETYPE, 
MAPALT TERMINATED 
Explanation: The device type 


specified is not supported by the 
MAPALT command. 


System Action: Execution of the 
MAPALT command is terminated. 


OQperater Response: Specify the 
correct davica type in the DEVICETYPE 
keyword of the command statement, and 
resubmit the job. MAPALT can only be 
executed on fixed block devices in | 
fixed block mode. 


Programmer Response: None. 


-ICK3i16032 UNABLE TO GPEN VOLUME 
Explanation: The volume that was 
specified cannot be opened. The ASSGN 
statement could be missing or invalid, 
or the channel and unit address could 
be invalid. 


System, Action: Execution of the 
MAPALT command 1s terminated. 


Cperaeter Response: Correct the error, 
and resubmit the job. 


Programmer Response: None. 


ICK31604I cuu LIMITS PARAMETER 

| INVALID AS SPECIFIED, 
MAPALT TERMINATED 

Explanation: The relative block 


number(s) specified by the LIMITS 
parameter are invalid. — 


System Action: Execution of the 
MAPALT command is terminated. 


Gperator Response: Correct the 
value(s) in the LIMITS parameter, and 
resubmit thea job. 


TECK3SL605I cuu UNRECOVERABLE I/760 ERROR 
DETECTED, MAPALT TERMINATED 
Explanation: An unrecoverable I/0 


error Cother than a date check?) was 
encountered. 


System Action: Execution of the 
MAPALT command is terminated. 


Operator Response: Check the job 
output, which will contain diagnostic 
information to aid in analyzing the 
error. Execute the Device Support 
Facilities ANALYZE command as a : 
Problem Determination aid, and follow 
installation procedures for recovery 
from this type of error. 


Programmer Response: None 


ICK3S1607I cuu MAPALT ABNORMALLY 
ENDED, REPORT NAY BE 
INCOMPLETE | 


Explanatien: This message is printed 
after an error has been encountered 
that caused execution of the command 


to be terminated. The report may be 
- incomplete. 


System Action: None. 

Operator Response: Check previous 
messages on job output, and follow 
Installation procedures. 


Programmer Response: None. 


ICKSLI6iiY MAIN STORAGE NOT AVAILABLE, 


MAPALT TERMINATED 


Explanation: Dynamic acquisition of 
storage for centrol blocks and wark 
areas failed. 


System Action: Execution of the 
MAPALT command is terminated. 


Operator Response: Increase main 
storage size; and resubmit the job. 


Programmer Response: None. 


ICK31700% VTOC EXTENT INVALID 
Explanation: The ending block number 
of the VTOC, which was computed from 
the FBAVTOC parameter, exceeds the 
hnighest block number of the FBA device | 
being initialized. 
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System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Cperator Response: None. 

Programmer Response: Correct the 
FBAVTOC parameter so the ending 
parameter is within the device limits, 
and rerun the job. 


Problem Determination: None. 


ICK3L705I ALTERNATE BLOCKS EXHAUSTED 
Explanation: <A prime block needed an 
alternate but all available alternate 
blocks have already been assigned. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Crerator Response: None. 

Progranmar Response: Reinitialize the 
volume with RECLAIM specified to free 
up some alternate blocks. If this is 
not successful, seek hardware support. 
Problem Determination: items 
1, 2s 3; G4 and 30. 


Table I, 


I/O ERROR FORMATTING BLOCK 
IDENTIFIER 


ICK317091 


Explanation: An uncorrectable error 
occurred while formatting the block 
identifier field of a block on a 3370. 


System Action: The command 
terminates. Device Support Facilities 
Processing continues with the next 
command. 

Operator Response: None. 
Progranner Response: 
support. | 


Seek hardware 


Problem Determination: 
1,2,3,4% and 3Q. 


Table I, items 


ICK31710I I70 ERRQR FORMATTING BAD 
BLOCK XXXXXX 
Explanatien: -An uncorrectable error 


occurred while formatting the 
defective block xxxxxx. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Crperatcr Response: None. 
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Programmer Response: Seek hardware 


support. 


Problem Determination: 
1,2,3,4 and 30 


Table I, items 


ICKSL711I CANNOT READ SA INFORMATION 
Explanation: Because of an I/0 error, 
the SA information—factory-flagged 
list-—-cannot be read. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: Seek hardware 
support. 

Problem Determination: items | 
15 ae 3, G and 30. 


Table I, 


ICK31712I INVALID SA INFORMATION 


FORMAT 


Explanation: The data format of SA 
information-—factory flagged list-—is 
in error. Typically, the end of data 
is not found. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. | 


Operator Response: None. 


Programmer Response: Seek hardware 
support. 
Table I, 


Problem Determination: items 


1, 2, 3, 4 and 30. 


ICKSL713I CANNOT READ PRIME CYLINDER 
IDS 


Explanation: An uncorrectable I/0 
error occurred while reading the ID 
fields of prime blocks. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 


Operator Response: None. 


Programmer Response: Seek hardware 
support. 
Table iy 


Problem Determination: items 


1,2,3,% and 30. 


ICK3L716I INVALID PARAMETER(S) FOR 
DEVICE TYPE: List of 


parameters 
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Explanation: Parameter(s) in the 
parameter list are invalid for device 
type being processed. For example, 
VTOC parameter specified for an INIT 
of an FBA device. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 


Correct 
and rerun the job. 


Programmer Rasponse: 
parameter(s), 


Problem Batermination: None. 


ICK31717I VERIFICATION FAILED: VOLI 
LASEL BOES NOT EXIST 
Explanation: Verification was 


requested, but failed becausa the 
volume being initialized does not have 
a VOL1 label to use for the verify. 
This may indicate this is the wrong 
volume. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next. 
command. | 
Operator Response: None. 
Programmer Response: 
conflict, 


Resolve the 
and rerun the job. 


Problem Determination: None. 


ICKS1718I INIT FAILED: VOLID NOT 
SPECIFIED AND I/O ERROR 
READING VOLUME LABEL 
Explanation: The VOLID parameter is 
not specified, and because of an I/0 
error, reading the volume label, a 
volume serial is not available. 


System; Action: The command | 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Proarammer Response: Try specifying 
VOLID. If this is not successful, 
investigate the cause of the I/0 error 
reading the volume label. 

Problem Determination: Table I, 
iy 2 4 and 30. 


items 
a» » hue D ay 


ICK31722I VERIFICATION FAILED: I-70 
ERROR READING VOLI LABEL 
Explanation: An uncorrectable I/0 


error occurred reading the VOL1 label. 
Verification cannot continue 
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System Action: Diagnostic information 
is printed on the output device. The 
command is terminated. Device Support 
Facilities processing continues with 
the next command. 
Operator Response: None. 

Procdrammer Response: Reinitialize the 
volume, specifying NOVERIFY and a 


VOLID. Start recovery procedures for 
data on the volume. 


Problem Determination: 
l, 2» 3» 4 and 30. 


Table I, items 


ICK31728I FBA MINIBDISK NOT SUPPORTED 
IN THIS ENVIRONMENT 
Explanation: Fixed block architecture 


minidisks are not supported in DOS, 
VS1, or MVS environments. 


System Action: The command 
terminates. Processing continues with 
the next command. 
Operator Response: None. 
Programmer Response: Execute the 
command in the stand-alone 
environment. 


Problem Determination: None. 


ICK31748I COMMAND CANNOT BE EXECUTED 
-= DEVICE ACCESS LIMITED 
Explanation: The current command 


cannot be executed because certain 
types of access are prohibited for the 
device you have specified. For 
example, a diagnostic control CCW 
cannot be issued for a VM minidisk. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 

Programmer Response: Check that the 
command you issued 15 compatible with 
the specified device. 


Problem Determination: None. 


ICK31749I DEVICE TYPE NOT SUPPORTED 
IN THIS ENVIRONMENT 
Explanation: Fixed block architecture 


devices ara not supported in the VS1 


or MVS environment. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 
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Operator Response: None. 
Programmer Response: Execute the 
command in the stand-alone or DOS 
environment. 


Problem Determination: Table I, items 
1% as and G& 
ICK31750IL TRACKS OR ALLTRACKS 


PARAMETER REQUIRED FOR CKD 
DEVICES 


Explanation: BLOCKS was specified for 
a count-~key-data device. You must 
specify either TRACKS or ALLTRACKS for 
these devices. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Resubmit the 
job, specifying either TRACKS or 
ALLTRACKS. 


Preblem Determination: 


Table I, items 
1, 3, and 4 


ICKSL751I BLOCKS PARAMETER REQUIRED 


FOR FBA DEVICE 


Explanation: TRACKS OR ALLTRACKS was 
specified for a fixed block 
architecture device. You must specify 
BLOCKS for these devices. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Responsa: Resubmit the 
job, specifying BLOCKS. 


Problem Daterminatian: 
1> 3> and Gq, 


Table I, items 


ICK31753I NO VALID BLOCK NUMBERS 


SPECIFIED 


Explanation: All the block numbers 
specified by the BLOCKS parameters 
were invalid. This message is preceded 
by one or more [CK11752I messages. 


System Action: The command 
terminates. Device Support Facilities 
processing continues with the next 
command. 

Operator Response: None. 
Programmer Response: Resubmit the 
job, specifying the correct block 
number(s) in the BLOCKS parameter. 
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continues with the 


Problem Determination: 
iy 55 and G 


Table I, items 


ICK31756I READ FOR PRESERVE OF BLOCK 
XXXXXX FAILED: 


UNRECOVERABLE I/O ERROR 


Explanation: The user data on block 
xXXXxXxx could not be read because of 
unrecoverable I/O errors. 


System Action: Diagnostic information 
is printed on the output device and 
processing of the block is terminated 
to prevent loss of the user data on 
the block. Command processing 
continues with the next valid block 
specified in the BLOCKS parameter. 


Operator Response: None. 


Prograinmer Response: None. 


Problem Determination: 
15 2> as G and 30. 


Table I, items 


ICK31757I READ FOR PRESERVE OF BLOCK 
XXXXXX FAILED: INSPECT ECC 


CORRECTION LOGIC FAILED 


Explanation: The read for the user 
data on block xxxxxx failed with an 
error correction code (ECC) 
correctable error, and the ECC 
correction information tn the sense 
did not correspond to the expected 
information for the executed CCW 
chain. 


System Action: Diagnostic information 
is printed on the output device, and 
processing of the command 15 
terminated. Device Support Facilities 
continues with the next command. 


Crerator Response: None. 


Programmer Response: None. 


Problem Determination: 
io os ao G and 29. 


Table I, items 


ICK31758I USER DATA CN BLOCK XXXXXXxX 
LOST 


Explanation: Command processing 
failed with a permanent error. 

Support Facilities was unable to 
restore the user data on block xxxxxx. 


Device 


System Action: The command is 
terminated. Device Support Facilities 
next command. 
Operator Response: None. 

Programmer Response: Start recovery 


procedures for the data set containing 
block xXxxxxX xX. 
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Problem Datermination: 
is Zs 3> G and 29. 


ICK3S1762I CHECK FUNCTION FOR BLOCK 
XXXXXX FAILED: 


UNRECOVERABLE I/O ERROR 


Explanation: An unrecoverable I/0 
error occurred during surface analysis 
of block xxxxxx. 


System Action: Diagnostic information 
is printed on the output device. The 
command is terminated, and Device 
Support Facilities continues with the 
next command. If you specified 
PRESERVE, you receive either message 
ICK31758I or message ICKO1759I on the 
output device to indicate the status 
of the user data on the block. 
Operator Response: None. 

See Problem 
Detarmination. 


Problem Determination: Table I, items 
15 Zs 3% G and 30. 
ICK3ZI763I ASSIGN FUNCTION FOR BLOCK 


XXXXXX FAILED: NO ALTERNATE 
BLOCKS AVAILABLE 


Explanation: An attempt was made to 
assign an alternate to block xxxxxx, 
and there are no more alternates 
available. 


System Action: The command is 
terminated. Device Support Facilities 
continues with the next command. If 
you specified PRESERVE, you receive 
either message ICK31758I or message 
ICKO1759I on the output device to 
indicate the status of the user data 
on the block. 
Cperator Response: None. 
Programmer Response: Retnitialize the 
device. 


Problem Datermination: items 


l> 2» 3, and 4 


Table I, 


ASSIGN FUNCTION FOR BLOCK 
XXXXXX FAILED? FORMAT 
DEFECTIVE BLOCK ERROR 


ICKI17641 


Explanation: An unrecoverable error 
occurred while using the format 
defective block CCW chain to assign a 
new alternate to block xxxxxx. 


System Action: Diagnostic information 
is printed on the output device. The 
command is terminated, and Device 
Support Facilities continues with the 
next command. If you specified 
PRESERVE, you receive either message 
ICK31758I or message ICK01759I on the 


Table I, items | 


| 


PE meena i ere neem 


output device to indicate the status. 
of the user data on the block. 
Operator Response: None. 


Programmer Response: 


see Problem 
Determination. 


Problem Determination: Table I, items 
ly 2% Sy G, and 30. 
ICK31766I ASSIGN FUNCTION FOR BLOCK 


XXXXXX FAILED: NO 
MON-DEFECTIVE AITERNATES 
FOUND 


Explanation: The format defective 
block CCW chain was retried 10 times 
for block xxxxxx and all ten assigned 
alternates failed surface analysis. 


System Action: The command is 
terminated, and Device Support 
Facilities continues with the next 
command. If you specified PRESERVE, 
you receive either message ICK31758I 
or message ICK017539I on the output 
davice to indicate the status of the 
user data on the block. 


OCperator Response: None. 


Programmar Response: See Problem 


Determination 


Problem Determination: Table I, items 
l> 2» ay G, and 30. 
ICK31767I ASSIGN FUNCTION FOR BLOCK 


XXXXXX FAILED: 
UNRECOVERABLE I/70 ERROR 
OCCURRED DURING SURFACE 
ANALYSIS 


Explanation: An unrecoverable I/0 
error occurred during surface analysis 
of the alternate assigned to block 
XXMXXX. , 


System Action: Diagnostic information 
iS printed on the output device. The 
command 1s terminated and Device 
Support Facilities continues with the 
next command. If you specified 
PRESERVE, you receive either message 
ICK31758I or message ICK01759I on the 
output device to indicate the status 
of the user data on the block. 


Operator Response: None. 


Programmer Response: See Problem 
Determination. 

Problem Betermination: items 
Ll; 2? S¢ 4, and 30. 


Table I, 


ICK31768I INVALID LOGICAL AND 
PHYSICAL DEVICE COMBINATION 
FOR REQUESTED FUNCTION 
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Explanation: 


The logical and physical 
device types were not equal. This was 
determined from the information 
returned from the sense ID (Sense I/0 
Type) CCH. Emulation of fixed block 
architecture devices 1s not supported 
by Device Support Facilities. 


System Action: The command is 
terminated, and Device Support 
Facilities continues with the next 
commana. 

Crerator Response: None. 

Proarammrer Response: Verify the 
device configuration is supported by 


Device Support Facilities. Sea Problem 
Datermination. 


Problem Detarminsation: Table I, items 
Ls fae S3 Gy and 29. 
TICK3L769I BEVICE RLOCK SIZE OF nnnn 


NOT SUPPORTED 


Explanation: The block size (nnnn) 
information returned by the device 
from a read device characteristics CCW 
does not equal 512. 


System Action: The command is 
terminated, and Device Support 
Facilities continues with the next 
command. 

Crerator Response: None. 
Frocramrrmer Response: 
Datermination 


See Problem 


Problem Determination: Table I, items 
1, 5% G, and 30. 
ICKS1L772r INSUFFICIENT STORAGE 


AVAELASLE TO READ VTOC 


Explanation: 
storage for an 


Dynamic acquisition of 
input buffer failed. 


System Action: The command is 
terminated and Device Support 
Facilities continues with the next 
command. 

Creratar Response: None. 
Proeremmer Response: Increase the 
amount of storage available for 
GETMAIN/GETVIS. 


Problem Datermination: Table I, items 
l> 34 and Gq. 

ICK3S1773I VOL LABEL NOT FOUND 
Explanation: An online volume does 
not have a VOLI label. 


Appendix C. 


Device Support Facilities Messages (CICK) 


System Action: The command is 
terminated, and Device Support 
Facilities continues with the next 
command. 

Operator Response: None. 

Programmer Response: Initialize the 
volume, or rerun the command in the 
stand-alone environment. 


Problem Determination: None. 


ICK31774I I/70 ERROR READING VOLI 
LASEL 


Explanation: A permanent I/0 error 
occurred reading the VOLI1 label. 


System Action: Diagnostic information 
15 printed on the output device. The 
command is terminated, and Device 
Support Facilities continues with the 
next command. 
OQrerator Respense: None. 
Programmer Response: 
volume, 


Reinitialize the 
and start recovery procedures 
for the data on the volume. The INIT 
command for reinitialization must 
specify the NOVERIFY and VOLID 
parameters. 


Problem Determinatien: 
1, 2» 55 4, and 398 


Table I, items 


TCK40c27I AN ‘ELSE’ 


INPROPERLY 


COMMAND APPEARS 


Explanation: An ELSE clause appeared 
in the command without a corresponding 
IF statement. 


System Action: The remainder of the 
command 15s ignored. Device Support 
Facilities processing continues with 
the next command. 
Crerator Response: None. 
Proaramner Response: 
command syntax, 
command. 


Correct the 
and reissue the 


Problem Determination: 
2» 4, and 29. 


Table I, items 


ICKSO02281 
Explanation: An END statement was 


encountered without a matching BO 
statement. 


AN "END* COMMAND IS INVALID 


System Action: The remainder of the 
command is ignored. Device Support 
Facilities processing continues with 
the next command. 


Ceerator Response: None. 
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Proqrammar Response: Correct the 
DO-END saquence, and reissue the 
command. 


Problem Determination: 
2 G, and 293. 


Table I, items 


ICK&0229I ‘"IF* COMMAND HAS INVALID 
RELATIGNAL EXPRESSION 


Explanation: The IF-THEN-ELSE 
statemant sequence is incorrect. Only 
the system variables LASTCC and MAXCC 
can be specified, and the values must 
be decimal numbers from 0 through 
99999. 


System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities processing 
continues with the next command. 


Operator Response: None. 


Prograirmer Response: Check the 
requirements of the IF-THEN-ELSE 
statement sequence, correct the error, 
then reissue the command. 


Problem Patermination: 
25 G and 29. 


Table I, items 


ICKE902301 "SET’ COMMAND HAS INVALID 
ASSIGNHENT EXPRESSION 
Explanation: A SET statement has 


invalid syntax. Only the system 
variables LASTCC and MAXCC can be 
assigned values, and the values must 
be decimal numbers from 0 through 
99999. 


System Action: The remainder of the 
command stream 1s ignored. Device 
Support Facilities processing 
continues with the next command. 


Cperator Response: None. 


Procdrammer Resronse: Check the syntax 
requirements of the SET statement, 
correct the error, then reissue the 
command. 

Problem Determination: Table I, items 
2» 4G, and 29. 


ICKGO0232I IMPROPER GR MISSING ‘"THEN’ 
KEYWORD 
Explanation: The THEN clause of the 


IF-THEN-ELSE command sequence 15 
missing or 18S misspelled. 


System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities procassing 
continues with the next command. 


Operator Response: None. 


Programmer Response: Correct the 
error, and reissue the command. 
Problem Determination: Table I, items 
2,» 4, and 29 


ICK40236I INPUT STREAM END-OF-FILE 
FOUND BEFORE END OF COMMAND 
Explanation: An end-of-file condition 


Was encountered while scanning the 
command. This could be caused by 
incorrect command-continuation syntax 
or missing records in the input 
stream. 

System Action: The command 
terminates. 


Cperator Response: None. 


Prograismer Response: Correct the 
command syntax, or add the missing 
records, then reissue the command. | 
Problem Determination: Table I, items 
ey 4, and 29. 


ICK40237I TOO MANY LEVELS OF ‘IF* 
COMMAND NESTING 


Explanation: More than ten IF 
statements have been nested. 


System Action: The remainder of the 
command stream is ignored. Device 
Support Facilities processing 
continues with the next command. 


Operator Response: None. 


Programmer Response: Restructure the 
command stream to avoid the excessive 
nesting, and reissue the command. 
Problem Determination: Table I, items 
2» 4, and 29. 


ICK40999I UABORT CODE nn 

Explanation: This message indicates a 
termination error causing the Device 
Support Facilities processor to abort. 
This situation is usually caused by 
program or system errors. The message 
appears in the output listing via the 
write-to-programmer SVC. Code nn 
indicates the nature of the error, 


Code Meaning 


24 Text processor's print control 
table not addressed by the GDT 


23 No virtual storage available 
for: 
e Page header line 


150 Device Support Facilities User's Guide and Reference 


32 


33 
36 


° Argument lists 

° Main title line 

. Footing lines 

° Print control table (PCT) 


° Initialization of the I/0 
adapter historical data and 
message area 


° Automatic (dynamic) storage 
for a module which uses 
preallocated automatic 
storage 


A GETMAIN/GETVIS request 
e Space for STAE control block 


® Open control-block 
allocation 


° Device Information Table 
(DIT) 


Note: The message that 
sufficient storage was not 
avatlable could not be issued 
because the SYSPRINT data set is 
not open. 


Request made to process unopened 
data sat 


Unable to cancel STAE control 


Processor unable to open 
SYSPRINT Cor whichever DD name 
15 used to denote the 
processor's standard Listing 
output data set) 
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40 Invalid U-macro argument list: 


UOPEN, UCLOSE, UPUT, 
UGSPACE, UGPOOL, UFPOOL 
UTIME 

UVOLCHK, UWTO 

USTAE 


44 Processor is unable to produce a 
dump Cthe SNAP system service 
was not successful: either the 
DSFDUMNP data set could not be 
opened, or not enough storage 
was available) 


52 Module not found for ULOAD 
72 Unsupported device type 
80 Invalid ACTIONKEY value 


88 Operator replied "T" to message 
ICK014D 
92 Dynamic device information table 


(DIT) does not exist. 


96 Equipment check occurred on 
device that is being processed 


System Action: Device Support 
Facilities terminates. 


Cperator Response: 
programmer. 


Notify the system 


Frodrarsmer Response: Correct the 
cause of the error, and restart Device 
Support Facilities. 


Problem Determination: 
1, 2, 3, 4, 29, and 30. 


Table I, items 
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APPENDIX BD. PROBLEM DETERMINATION TABLES 


Problem datermination is the activity required to identify a 
failing hardware unit or program and to determine who is 
responsible for support. 


Problem determination is accomplished by using procedures 
specified by IBM. In some cases, these procedures may be 
initiated by a message or code that requires operator or 
programmer response. The response may include the requirement 
for additional problem-related data to be collected and will 
attempt, where possible, to indicate "probable” failure 
responsibility. 


Problem determination information 15 tncluded (for OS/VS) for 
applicable massages and codes under the heading "Problem 
Determination.” Standard problem datermination actions are 
identified as items of Tables I and II. Unique actions are 
idantified following the list of standard actions to be taken. 
In any case, it is intended that the specified actions ba taken 
before calling IBM for support. 


TABLE I 

If the problem occurs again, follow the problem determination 
aids specified by the associated message cr code before calling 
IBM for support: 


1. If MSGLEVEL=€1,1) was not specified in the JOB statement, 
specify it and rerun the job. 


2. Save the console sheet from the primary console. In systems 
with remote consoles, save the remote console sheet. In 
systems with Multiple Console Support (MC5), save a copy of 
the hard copy log. | 

3. Save the job stream associated with the job. 

4. Save the system output CSYSOUT) associated with the job. 

5. Make sure that the failing job step includes a: 

a. SYSABEND DD statement 
b. SYSUDUMP DD statement 
Cy PLIDUMP DD statement 
d. SYSMDUMP DD statement 


6. Make sure that the PARM parameter of the EXEC statement 
specifies the following: 


a MAP 

b. LIST 

c. DIAG 

d. MSG=AP 

e. CORE, if applicable 
f. XREF 

g. DUMP 


7. If SMP is used to make all changes to the system, run the 
LIST CDS and LIST PTFBY functions of SMP to obtain a list of 
the current maintenance from the SMP control data set (CDS). 


152 Device Support Facilities User’s Guide and Reference 


iQ. 
ie 


Le 
aor 
14. 


nom 


16. 
Ld x 


ig. 


tos 
20. 


If any changes are made to the system without using SMP, run 
the LISTIDR function of the AMBLIST or HMBLIST service aid 
program to obtain a list of all members with a PTF or local 
fix, and save the output. Run the program against the: 

a. SYSI.LINKLIB data set 

b. SYSI.SVCLIB data set 

c. Library containing the program that issued the message 
d. SYS1L.LPALIB data set 

Run the IMCJOBQD Cstand-alone) or IMCOSJQD Csystem-assi sted) 
service aid program to obtain a formatted copy of the 
contents of the SYSI1.SYSJOBQE or SYS1I.SYSWADS data sets, 
SWADS or the resident job list. 

Run the AMBLIST or HMBLIST service aid program to obtain: 


a. An object module listing, specifying the LISTOBJ 
function 


b. A load module map and cross-reference listing, 
specifying the OUTPUT=BOTH option of the LISTLOAD 
function 

Have a copy of the Message Control Program (MCP) available. 

Run the AMDSADMP or HMDSADMP service aid program to dump the 

contents of real storage and page data sets on magnetic 

tape. 

After restarting the system, process the appropriate 

function of the AMDPRDMP or HMDPRDMP service aid program to 

print the required portion of the dump tape produced by that 
program. 

Save both the tape from the AMDSADMP or HMDSADMP service aid 

program Cshould further information from the tape be 

required) and the ene from the AMDPRDMP or HMDPRDMP 
service aid program. 

Run the SEREP program, and save the resulting output. 

Save all the associated output. 

The normal response to this message requests the programmer 

and/or operator to run a specific program. Save all output 

from that program. 

Save the program listing associated with the job. 

Save the dump. 

Have the system-generation (CSYSGEN) output available from: 

a. Stage I[ 

b. Stage II 

Run the IFCEREP1 service aid program to dump the SYS1.LOGREC 

data set and save the resulting output. For MSS, run the 

following program to dump the SYS1.LOGREC data set. 

a. Service aid IFCISDA0 

b. Program ISDASDAO with the DETAILCALL) parameter 

Save the assembly listing associated with the job. 


Save the control cards associated with the job. 
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21. 
22. 
23% 
24. 


25. 


26. 


ee 


36. 


Save the compiler output associated with the job. 
Save the source input associated with the job. 
Save the source program listing associated with the job. 


Run OLTEP diagnostics for the problem device and save the 
output. 


Run the IEHLIST system utility program to obtain a list of 
the: 


a. Volume table of contents of the associated volume, 
specifying the FORMAT option 


b. Volume table of contents of the associated volume, 
specifying the DUMP option 


c. Directory of the associated data set 


d. System catalog Cif it is not a VSAM catalog) 
Run the IEBPTPCH data set utility to print the: 
a. Directory of the applicable data set 

b. Applicable data set 

c. Applicable member 

d. Applicable procedure 

Have the linkage editor/loader map available. 
Save the associated volume. 

Contact IBM for programming support. 

Contact IBM for hardware support. 

Save the trace output data set. 


Print the GTF trace data set with the AMDPRDMP or HMDPRDMP 
service aid program using the EDIT statement. 


Print the associated SVC dump data set, with the AMDPRDMP or 
HMDPRDMP service aid program using the GO statement. 


. Issue the Access Method Services LISTCAT command to list: 


a. The contents of the applicable catalog 


b. The catalog entries for the applicable objects and any 
related objects 


Issue the following Access Method Services command: 
a. The MSS LISTMSF command for mountable volumes 
b. The MSS LISTMSF command with the CARTRIDGES parameter 


c. The PRINT command to list the contents of the mass 
storage volume control inventory data set 


d. The LISTMSVI command 
e. The LISTMSF command with the ALL parameter 


Issue the Access Methods Services PRINT command to print the 
repair workfile. 
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38. 


A ae 
G0. 
41. 


42. 


43. 


44. 


45. 


46. 


47. 


48. 


49. 


Run the AMASPZAP or HMASPZAP service aid program using the 
ABSDUMP statement to print the contents of the applicable: 


a. Data set 
b. Track, and save all associated output 


Issue the Access Method Services AUDITMSS command with the 
following: 


a. The CHECK parameter 

b. The MAP parameter 

c. The READLABEL parameter 

Issue the Access Method Services CHECKMSS command. 
Issue the Access Method Services COMPARET command. 


Issue the Access Method Services DUMPMSS command to dump the 
following: 


a. Formatted mass storage control storage 
b. Mass storage control main storage 

c. Mass storage control extended storage 
d. Formatted Staging Adapter storage 

e. Staging Adapter main storage 

f. Staging Adapter extended storage 

g. Mass storage control tables 


Save the latest output from the Mass Storage Control Table 
Create program. 


Display the units for devices associated with the problem 
area. If a specific unit or units are not known, display the 
range of all virtual units. See your path chart for address 
ranges. 


Obtain the RACF profile of the associated data set where 
applicable. 


Stop the processing unit and use the hardware ALTER/DISPLAY 
facility to display: 


a. All general purpose registers 
b. The page status word 


c. Main storage locations 0-200 Chexadecimal) and 7000-7080 
(hexadecimal } 


If the AMDSADMP or HMDSADMP program resides on tape, save 
the tape. If it resides on disk, use the DUMP feature of the 
IEHDASDR program to print the SYS1.PAGEDUMP data set and 
cylinder 0, track 0 of this residence disk. 


Save the output Clistings) of the stage 1l and stage 2 
AMDSADMP or HMDSADMP initialization jobs. 


Follow the procedures for item 9b of this table for load 
modules A/HMDSAPGE, A/HMDSAPRO, and A/HMDSALDR of 
SYSI.LINKLIB. Use IEBUPDTE or TEBPTPCH to print the 
A/ZHMDSADMP and A/MDSADM2 macros from SYS1.MACLIB. 


Save the AMDSADMP or HMDSADMP dump output Ctape or listing). 
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50. If the program seems to be looping, use the display PSW 
feature of the hardware ALTER/DISPLAY facility along with 
the hardware Instruction Step facility to trace the loop, 
instruction by instruction. 


51. If there is an error in the contents of a page data set 
dump, restart the system using a different page data set, 
then dump the original page data set using the DUMP feature 
of IEHDASDR. | 


52. Use IEBCOPY to unload SYS1.IMAGELIB to tape. 
53. Have a list of RACF-defined entities available. 


TABLE II-—-GTF for Problem Determination 
Format 1: Tracing Without Prompting for Event Keywords 


Before reproducing the problem, have the system operator issue 
the START GTF command specifying the tape output, MODE=-EXT, and 
TIME=YES. In response to the AHL100A or HHLIO0OA message, the 
operator should type TRACE=opt, where opt is the trace option 
indicated for the particular message or code, within the text of 
the reply. 


When data for the problem has been recorded, run the AMDPRDMP or 
HMDPRDMP service aid program using the EDIT statement to format 
the trace output, specifying DDNAME= Cddname of the trace data 
set). 


Format 2: Tracing Nith Prompting for Event Keywords 


Before reproducing the problem, have the system operator issue 
the START GTF command specifying tape output, MODE=EXT, and 
TIME=YES. In response to the AHL100A or HHLI1O0A message, the 
“system operator should specify the trace options indicated for 
the associated message or code within the text of the reply. 
Then,» in response to the AHLIOOA or HHL1OOA message, the system 
operator should specify the event keywords also indicated with 
the associated message or code. 


When data for the problem has been recorded, run the AMDPRDMP or 
HMDPRDMP service aid program using the EDIT statement to format 
the trace output, specifying DDNAME= Cddname of the trace data 
set). | 


Format 3: Specialized Tracing Action 


Before reproducing the problem, have the system operator issue 
the START GTF command specifying tape output, MODE=EXT and 
TIME=YES. In response to the AHLIOO0A or HHL100A message, the 
system operator should type 'TRACE=SYS,USR'. The DD statement 
for a data set in error should specify DCB=DIAGNS=TRACE. 


When data for the problem has been recorded, run the EDIT 
function of AMDPRDMP or HMDPRDMP service aid program, specifying 
the options SYS and USR=FFF. 


Format 4: Specialized Tracing Action for VSAM 


Before reproducing the problem, have the system operator issue 
the START GTF command specifying tape output, MODE=EXT and 
TIME=YES. In response to the AHL100A or HHLIOOA message, the 
system operator should type "'TRACE=SYS,USR'. The DD statement 
for a data set in error should specify AMP=TRACE. 


When data for the problem has been recorded, run the EDIT 


function of the AMDPRDMP or HMDPRDMP service aid program, 
specifying the options SYS and USR=CFFF,FF5). 
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APPENDIX E. THE 


CALCULATING THE 


VTOC INDEX 


The VTOC index 15 a Separate, sequential data sat containing 
four record types that give information on volume and VTOC 
status. Systems that contain and use indexed VTOC programming 
support can realize performance improvements in the areas of 
volume space management and I/0 operations to the VTOQC. 


The INIT and BUILDIX commands will build the VTOC index on 
eligible count key data devices. The INIT command creates the 
index during volume initialization in both operating system and 
stand-alone environments. The BUILDIX command, which requires 
that the host operating system contain indexed VTOC programming 
support, builds VTOC indexes on volumes currently in use on the 
system. Both commands prepare the VTOQC on the target volume to 
indexed VTOC CIXVTOC) format. 


Thea four record types in the index provide the system with a 
comprehensive means of space management compared to nonindexed 
methods. The four record types are: 


1. The VTOC index map CVIXM) is the record that maps the index 
itself. It contains a one-for-one bit map of the records in 
the index, showing which records are in use (bit set to one) 
and which recorads are free to be assigned (bit set to zero). 
The programs reserve index space for a maximum of two VIXMs. 


2. The VTOC pack space map (CVPSM) contains separate bit maps 
for management of space on the volume at both cylinder and 
track level. Free and allocated space is represented in 
these maps. A maximum of five VPSMs are reserved by the 


programs. 


Note: The VPSM is built using the information in the 
format-4 BSCB which gives the number of cylinders on the 
volume as the sum of the primary cylinders plus the number 
of alternate cylinders. This value is shown in the VPSM. 
However, the alternate cylinders as well as all otner unused 
bits in the bit maps are marked as allocated. 


3. The VTOC map of DSCBs CVMDS) contains a bit map showing free 
(bit set to zero) and allocated (bit set to one) data set 
control blocks in the VTOC. A maximum of two VMDSs are 
reserved. ; 


a. The VTOC index entry record (VIER) contains pointer entries 
to each format-i DSCB in the VTOC. Entries are built in the 
VIER using the DSCB key (data set name) and the disk address 
Ceylinder, head, record number} of the format-1 DSCB. The 
number of VIERS is variable to the maximum of total index 
records reserved minus the records used by the other three 
record types. | 


SIZE OF TRE VTOC INDEX 


The size of the index data set depends upon: 


1. The size of the volume (total number of cylinders and 
tracks) 


2. The track length Cin bytes) 
3. The number of tracks occupied by the VTOC 
For the INIT command, the user may calculate the number of 


tracks toa reserve for the index and place that value as the 
third, optional subparameter of the INDEX parameter; or the 
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third subparameter may be omitted and the program allowed to 
calculate the size of the index. For the BUILDIX command, the 
user must calculate the size of the index. 


In calculating the size of the index, the INIT command 
determines the number of VIXM, VPSM, and VMDS records needed 
(not exceeding the established maximum for each type), and 
assumes that all VTOC DSCBs are Cor could be) format-1 DSCBs and 
that each VIER manages a maximum of 48 format-1 DSCBs; higher 
level VIERs and varying length data set names are taken into 
account by the choice of 48 format-1 DSCBs. 


For efficient use of DASD space, it is recommended that you 
calculate the number of tracks to reserve for both the VTOC and 
the index data set. Figure 16 shows the maximum values for VTOC 
and VTGC index size for the devices that can support the VTOC 
index. It is not likely that the assumptions used to generate 
tha chart would be valid in an actual situation. However, the 
chart places the upper limits for calculating maximum usable 
space. Space reserved above these limits is wasted. 


DEVICE a 


# OF RECORD TYPES4 


VPSM5 | VMDS6 | VIER? 


ssf s [so] «7 | [7 |e 


This maximum value assumes that all data sets on the volume are single 
track data sets. 

“Index record length of 2048 bytes. | 

SThis maximum value assumes that the VTOC is the maximum size. 

SThe first VIXM map will manage up to 7840 index records. (One VIXM is 


more than sufficient for current devices.) The second VIXM will manage 
an additional 16032 records. 

‘5S The number of VPSMs required for a device is dependent upon its size. 
16032 bits are available for cylinder and track mapping in each VPSM 
Ca maximum of 5 VPSMs is currently reserved). 

The first VNDS will manage 16032 DSCBs. The second Cand last) VMDS 
Will manage an additional 16032 DSCBs. 

eee ee is assumed to contain 48 entries (Cpointers to each Format-l 

B). 


Figure 16. Table of Maximum VTOC and VTOC Index Sizes 


To calculate VTOC size, you generally determine the maximum 
number of data sats that will reside on the volume. The number 
of VTGC tracks to reserve can be easily calculated by dividing 
this number by the number of DSCBs per track, rounding to the 
next higher track. 


To calculate the number of tracks to reserve for the index, 
first determine the average data set name length of the format-l 
DSCBs which will reside on the volume. If the length chosen is 
too small, the data set names may not fit in the index. If the 
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length chosen is too large, some space 15 unused in the index. 
Next determine the maximum number of data sets that will reside 
on the volume. Then calculate the number of VIERS needed to 
contain that many data set names of the chosen average data set 
name length, using the calculations shown below. For the number 
of VIXM, VPSM, and VMDS records, refer to the chart for actual 
numbers. CNote that the 3330-11 and 3350 will always require two 
VPSMs, and a 3350 with a maximum-size VTOC will require two 
VMDSs.) Add together the totals of all four record types and 
divide by the number of index records per track, rounding to the 
next higher track, to get the number of tracks to reserve for 
the index. 


The value calculated for the index size is to be placed as the 
third subparameter of the INDEX parameter on the INIT command 

statement; or it is to be placed as the number of tracks to be 
allocated in the SPACE or ABSTR parameter in the DD statement 

required to execute the BUILDIX command. 


The following shows the calculations to determine the number of 
VIERS needed to contain N data set names, each of which has an 
average data set name length of D. The calculations assume that 
all VIERS except one at each level are half filled, that a new 
level of the index is created when four lower level VIERSsS are 
created, and that ntl unused VIERS are required for an n-level 
index. 


Calculate the number of VIERs as follows where: 


7 
[1 


D 
Fi 


round quotient down to integer value 


round quotient up to integer value 

number of data set names in the index 

average data set name length 

number of data set names that fit in the 

half-filled level 1 VIER 

E* = number of data set names that fit ina 
half-filled level 2 or greater VIER 

L(€n) = number of VIERS at level n 


iow Wu 


[2447 D438) | *¥ G = Et number of data set names that fit 
in a half-filled level 1 VIER 
|2447(D+7) | * G = EA number of data set names that 


fit in a half-filled level 2 or 
greater VIER 


Calculate L€n) (where n 15 1,2,3,...). and L€n) is the 
number of VIERs at level n 


Ryasen = L€1) number of level 1 VIERs. Use L(€n)=1 if 
calculation yields zero. 
For n=2,3,... Ltn) is calculated from L(€n-1) 
If L€n-1) 2 4 then 
lucn-1)7E2]-1 = Ln) Use LO€n)=1 if calculation 
yields zero. 


If L(€n-1) < 4, then there are no VIERs at level nor higher. 


Tne total number of VIERs is 
L¢ci) + LO2) + 1... + LON) 
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The assumptions used for the above calculations represent the 
state of the index immediately after building it using the 
BUILDIX command. The state of the index is such that the 
largest number of VIERs possible are usad to contain the data 
set names. However, since the data set names on a volume will 
not all have the same length, the calculations should be used as 
an approximation. You should choose N (maximum number of data 
set names) and D conservatively to account for the varying 
number of data set names that will fit in a VIER. 
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APPENDIX F. THE FIXED BLOCK ARCHITECTURE VTOC (FBAVTOC) 


FBAVTOC FORMAT CHARACTERISTICS 


VTOCS on FBA devices are formatted In a similar manner to VSAM 
relative record data sets in that the 1460-byte label records are 
stored in control intervals. For example, three labei records 
fit into a 512-byte control interval. The control interval size 
15 always an integral multiple of the device's physical block 
size. The upper limit is 8192 bytes. 


eauivalent to number of file label records. It can range froma 
minimum of 3 slots to a maximum of 999 slots, fitting into as 
many control intervals as required. The program rounds up the 
extent values to that of the next full control interval. 


The FBAVTOC's starting location can be any physical block on the 


pack, except for blocks 0 and 1, Which are reserved for the IPL 


The FBAVTOC extent is expressed in number of 'slots'", which is 
| and volume label blocks CVLB). 


A standard (Cnon-SYSRES) FBAVTOC has the following default 
characteristics: 


| @ Starting location——block 2, immediately after the VLB 
| « Extent-——-56 file label records 


e Control interval size—1024 bytes Cor FBA block size, if 
larger) 


| LABEL RECORD FORMAT 


Each record of the FBAVTOC contains 140 bytes, written as binary 
zeros. The first two records of the FBAVTOC are reserved for 
specific records: 


| @ The data set control block (Cformat 4) of the FBAVTOC 


| @ The space management label (format 5) 


as hexadecimal 5s (¢€X'05'). The 45th byte of the space management 


| The first 4-byte field of the space management label is written 
label is written as hexadecimal X'F5"., 


| Each control interval of the FBAVTOC contains a fixed number of 
slots and has the following format (Figure 17). 


| 
a 4 / 
— bieenead Lt 
n 
, | 


7 


310A 
M1 7 
Mm T11O w 
NOHO 


Figure 17. Format of a FBAVTOC Control Interval 
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There is one RDF Crecord definition field) associated with each 
slot in a control interval. The length field in the RDF (bytes lL 
and 2) contains the slot length, which is equal to the label 
record length. Bit 5 of byte 0 of the RDF indicates whether the 
associated slot contains a record/label (bit 5=0) or not (bit 
5=1). The RDF has one of the following contents: 


° X'O00008C' if the slot contains a label. 


e X'04008C' if the slot does not contain a label, that is, it 
is empty. ; 


The number of labels per control interval CLBPCI) is determined. 


by the formula 


LBPCI = FLOOR of (CCISIZE-4)/CRECSIZE+3) 
where: 
FLOOR takes the integral part of the argument 


CISIZE control interval size 
RECSIZE label record size, which is equal to 140 


fE Of 


LBPCI is recorded in the standard volume label (VOL1) in bytes 
29 through 32 


The control interval definition field (CIDF) has the following 
format: 


Bytes 0,1 -free-space offset = RECSIZE * LBPCI 
Bytes 2,3 free-space length = CISIZE-4-LBPCI * CRECSIZE+3) 


FBAVTOC SPACE REQUIREMENTS 


| 
| 


[ae ones the space required for a fixed block architecture 
The number of labels per control interval (LBPCI) is determined 
by the formula : 
LBPCI = FLOOR of (CISIZE-4)/(CRECSIZE+3) 
where: | 
FLOOR takes the integral part of the argument 


CISIZE control interval size 
RECSIZE label record size, which is equal to 140 


ff ft 


The number of control intervals required for the FBAVTOC is 
CEILING of Cnumber of labels specified/LBPCI) 
where: | 


CEILING takes the next highest integer if there 15 a remainder 


The number of physical blocks reserved for the FBAVTOC is 
CI * CCISIZE/physical block size) 
where: 


CI = number of control intervals required for the VTQC 
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APPENDIX G. SURFACE ANALYSIS 


| PRIMARY ANALYSTS 


Grecian ene ae ES A A 


| dearer ed ener se erp ERE Lc 


Surface analysis for a volume or track is performed when you 
specify the CHECK(n) parameter on aither the INIT or INSPECT 
command. . 


There are two types of surface analysis, primary and skip 
displacement. Primary analysis is performed for all davices 
supported by Device Support Facilities, skip displacement 
analysis 1s performed only for the 3375 and 3380. 


Primary analysis is performed for all devices supported by 
Device Support Facilities when you specify CHECK(n). It consists 
of writing and reading back a number of bit patterns for the 
specific device (see below for the values for n by device). 


Primary analysis for count key data davices consists of the 
following: 


1. A bit pattern for the specified device is written and read 
back once 


2. If a data check is detected Ccorrectable or uncorrectable) 
the following is performed: 


e For devices with skip displacement support (€3375, 3380), 
Skip Displacement Analysis (see below) is performed on 


the track. 

° For devices without skip displacement support, the bit 
pattern is reread up to 10 times to determine if the 
error 15 repeatable. If the error is not repeatable 


processing continues. 
If the error 15 repeatable: 


= For correctable errors, a message is issued and 
processing continues with the next track. If you 
want to assign an alternate to that track, use 
INSPECT NOCHECK ASSIGN TRACKS 


= For uncorrectable data checks an alternate track is 
assigned if ASSIGN is specified. 


3. This 15 repeated n times (from CHECK(n)) unless a data check 
1S encountered. Each pass through uses a different davice 
dependent bit pattern. If all the patterns for the device 
are used, the sequence of patterns is repeated starting with 
the first pattern used. See below for the values of n that 
write each bit pattern at least once. 


Primary analysis for fixed block architecture devices consists 
of the following: 


1. A bit pattern for the specified device is written and read 
back once. 


2. If a correctable data check is detected, the block is reread 
10 times to determine if the error 18s repeatable. 


3. If an uncorrectable data check or repeatable correctable 
data check is encountered and ASSIGN is specified, an 
alternate is assigned and the process is restarted to 
analyze the surface of the alternate. 
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This is repeated n times (from CHECK(n})) until it is performed 
without encountering any uncorrectable data checks or any 
repeatable correctable data checks. Each pass through uses a 
different device dependent bit pattern. If all the patterns for 
the device are used, the sequence of patterns is repeated 
starting with the first pattern used. See below for the values 
of n that write each bit pattern at least once. 


| SKIP DISPLACEMENT ANALYSIS 


| CHECKIN) VALUES 


Skip displacement analysis is performed only for 3375 and 3380 
devices and consists of surface checking to locate and skip over 
defective areas on the track. If more than the maximum number 
of defects allowed are detected, an alternate track is assigned 
automatically if you are performing an INIT function or tf you 
specify ASSIGN with the INSPECT function. Note that skip 
displacement analysis is a time consuming operation. 


Skip displacement analysis is performed directly when you 
specify INSPECT TRACKSC...) CHECK (n). In this case, primary 
analysis 1s not performed and the value of n is ignored. 


Skip displacement analysis is performed indirectly when you 
specify INSPECT ALLTRACKS CHECK(n) or INIT CHECK(n) and primary 
analysis indicates the possibility of a repeatable data check. 
Note that INSPECT ALLTRACKS is a time-consuming operation. 


The n values shown below give one pass through each bit pattern. 
Specifying a value of n greater than these values causes the 
same bit pattern to be rewritten. As this is a time consuming 
option, you should think about performance considerations. 


@ 2305, 2311, 2314, 3310, 3330, 3330-1, 3344, 3350, 3370. n=3 


gives one pass through each bit pattern. 


° 3375, 3380. n=2 gives one pass through each bit pattern if 
you specify INSPECT ALLTRACKS CHECK(n) or INIT CHECK(n). If 
you specify INSPECT TRACKS(C...) CHECK(n), skip displacement 
analysis is automatically performed. (n is ignored). 
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The entries in this index are shown as 
they appear tn the text of the book; 
that 15, words that appear in all 
uppercase in the text are also spelled 
that way here. 


abbreviating commands and 
parameters 22 
abbreviations of commands 
INSPECT 66 
REFORMAT 80 
abbreviations of parameters 
ALLTRACKS 68 
ASSIGN 72 
BLOCKS 68 
BOOTSTRAP 
CHECK 50,70 
DDNAME 28,40,48,67,80 
DEVICETYPE 48,69,78 
DETAIL 78 
DOSVTOC 52 
IPLDD 56,83 
IXVTOC 41 
LABELS 55 
LIMITS 29,77 
OSVTOC 41 
OWNERID 54,82 
PURGE 41,49,81 
PRESERVE 71 
RECLAIM 51,70 
SCAN 28 
SYSNAME 77 
TRACKS 68 
UNITADDRESS 28,48,67,77,80 
VALIDATE 50 
VERIFY 48,68,81 
additional volume labels, 
space for CINIT) 54 
alternate track associations (CKD 
devices) 88 
alternate tracks 
inspecting a volume for conditional 
assianment of, 
example CINSPECT) 73 
inspecting a volume for 
unconditional assianment of, 
example CINSPECT) 73 
inspecting to assign 65 
number of detects before 
assignment 46,65 
specifying assignment of 
CINSPECT) 72 
ANALYZE command 
assumptions 26 
data verification test 
messages 39 
description 3,4,5,25-30 
diagnostic messages 32,35 
drive test 26 
messages 35-37 
examples 30-32 
fixed head error table 34 
mapping head numbers 38 
movable head error table 33 
parameter descriptions 28-30 


57,85 


reserving 


27 


syntax 28 
using output 25 
what tested 26 
analyzing a voluma in a 
DOS/VSE environment, 
example 31 
APF 
CAuthorized Program Facility) 
ASSGN statement (DOS/VSE) 16 
assigning alternate tracks 
CINSPECT?) 72 
Authorized Program Facility 9 
auxiliary storage requirements 


blocks CFBA) specifying 
bootstrap records 
IPL 92 
writing IPL 
INIT 57 
REFORMAT 83. 
Building a VTOC Index, 
CBUILDIX) 43-44 
BUILDIX command 


63 


examples 


description 40 
examples 42-44 
syntax 490 


CARD, input device specification 
Caution: NOPRESERVE parameter 
CINSPECT) 71 
changing a VTOC format CBUILDIX) 
IxvToc TO OosSvTac 4il 
OSvVTGe TO IxvToc 4i 
checking surface of the volume 
INIT 509 
INSPECT 69 
CHECK (Cn) values 
command execution, 
commands 
23 
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controlling 


abbreviating 
ANALYZE 354%,5,25-390 
data verification test 
messages 39 
diagnostic messages 32,35 
drive test 26 
drive test messages 35-37 
examples 30-32 | 
fixed head error table 34 
mapping head numbers 3&8 
movable head error table 33 
syntax 28 
BUILDIX 40-44 
description 40 
examples 42-44 
syntax 40 
comments 23 | 
delimiters 23 
INIT 6,45-62 
description 6,45 
examples 59-62 


Tndex 


16 


i3 
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syntax 47 
INSPECT 7,65-75 
description 6,65 
examples 73-75 
syntax 66 
MAPALT 7,76-79 
description 6,76 
examples 79 
syntax 77 | 
line continuations 
REFORMAT 7,80-86> 
description 7,80 
examples 85-86 
syntax 80 
terminator 23 
usage table 4 | 
condition codes to control command 
execution 16 
conditional assignment of alternate 
tracks, inspecting in online mode 
(OS/VS), example CINSPECT) 73 
continuation lines, IF statement 20 
IF-THEN-ELSE statement 
sequence 17-20 
cylinder 0, track 0 layout 91 


20,23 


data, preventing destruction 
during inspection CINSPECT) 71 
data set security and protection 8-10 
APF 9 | 
in a stand-alone environment 8 
in an offline mode (COS/VS) 8 
in an online mode (OS/V5) 8 
in DOS/VSE 10 
data set, printed output 15 
data verification test messages 
CANALYZE) 39 | 
date, specifying when loading 
Device Support Facilities 
program 13 
defect skipping 
INIT 46 | 
REFORMAT 65,66,69 
defective tracks 
inspecting for, INSPECT 65 
reclaiming CINIT) 51 
reclaiming CINSPECT) 70 
delimiters 23 


davice 
identifying the type CDEVICETYPE) 
INIT 48 
INSPECT 69 


Device Support Facilities commands, 
list of 4 

Device Support Facilities level 3 

Device Support Facilities messages, 
Appendix C ICK 96-136 

device on which the volume is mounted, 
identifying CUNITADDRESS) 


ANALYZE 28 
INIT 47 
INSPECT 67 
MAPALT 77 


REFORMAT 80 
diagnostic messages CANALYZE) 
direct-access storage devices 
supported 2,4 
DO clause, IF statement 17,18 
DOSVTOC parameter, INIT 52 


32,35 


Le | 


ELSE clause 
IF statement 
null 18 

emulated partial disk, 
initializing at the minimal 
level in DOS/VSE 62 
inspecting an 75 

emulation of count key data 
device ona fixed block 
architecture device 58 

END clause, IF statement 17,19 

error conditions in stand-alone 

environment 13 

error tables CANALYZE) 
fixed head 34 
moveable head 33 

examples using the Device Support 

Facilities commands 
ANALYZE command 30-32 
BUILDIX command 42-44 
INIT command 23,59-62 
INSPECT command 73-75 
MAPALT command 79 
REFORMAT command 85-86 
exclusive control 
OS/VS 19 
DOS/VSE 19 
EXEC statement, executing Device 
Support Facilities 
in OS/VS 16 
in DOSZVSE 16 
executing Device Support 
Facilities 11-16 
in a stand-alone environment 
in DOS/VSE 16 
in OS/V¥VS 14-15 
job control language 15 
loading the program 11. 

execution of command, controlling 16 

existing data, writing over on 

previously initialized volume 
(INIT) 49 


FBAVTOC 

description 161 

parameter 52 

space requirements 162 
fixed block architecture (CFBA) devices 
3 


17,18 


11-14 


BLOCKS parameters 68 
FBAVTOC parameter 52 
initializing 45,46,50 
minidisk support 95 

fixed head error table 
CANALYZE) 34 


general layout of a volume 88 
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[| 


home address 
standard format 932 
validating CINIT) 50 


[x | 


identifying 
owner, from 152 
the console 12 
the device where the volume is 


mounted 
ANALYZE 28 
BUILDIX 40 
INIT 47 
INSPECT 67 
MAPALT 77 


REFORMAT 80 
the input device 12 
the output device 13 
the type of device (DEVICETYPE) 
INIT 48 
INSPECT 69 
restriction 69 
MAPALT 78 
REFORMAT 80 
IF statement 17-290 
continuation lines 20 
nested IF statement 18 
IF-THEN-ELSE statement, example 20 
IF-THEN-ELSE statement sequence 17-20 
Index, The VTOC CAppendix E) 157 
Indexed VTOC CIXVTOC) 41 
INDEX parameter CINIT) 53 
INIT command 
description 6,45-62 
examples 59-62 
syntax 40 
initialization 
maximal lavel 46 
medial level 46 
minimal level 45 
initializing a minidisk in stand-alone 
environment, examples CINIT) 61,62 
initializing an emulated partial disk 
at the minimal level in the DOS/VSE 
environment, example 62 
initializing a volume 6,45-59 
at medial level as Mass Storage 
System Staging Pack, 
example (CINIT) 61 
at the maximal level ina 
stand-alone environment, 
example CINIT) 60 
at the medial level ina 
stand-alone environment, 
example CINIT) 60 
at the minimal level in the 
DOSY VSE environment, 
example 62 
at the minimal level in online 
mode (COS/VS), 
example CINIT) 60 
for the first time in offline 
mode COS/VS), 
example CINIT) 60 
initializing a volume with an 
index (€OS/VS) 62 


initializing two volumes in 
offline mode (O0S/VS), CINIT) 61 
input devices supported in 
stand-alone environment, list of 12 
INSPECT command 
description 7,65 
examples 73-75 
syntax 66 
inspecting a minidisk 
stand-alone environment, 
examples 74 
inspecting a volume 
for conditional assignment of 
alternate tracks in online 
mode (OS/VS), 
example CINSPECT) 73 
for defective tracks or blocks 
CINSPECT) 65 
for unconditional assignment of 
alternate tracks in offline 
mode COS/VS), 
example CINSPECT) 73 
to assign alternate tracks 72 
to reclaim tracks 66 
to reclaim tracks CINSPECT), 
examples 
in offline mode (OS/VS) 74 
in DOS/VSE 76 
inspecting an emulated partial 
disk (DOQS/VSE), example 75 
Inspecting an entire volume toa 
produce a volume map ina 
stand-alone environment, 
example CINSPECT) 74 
IPL bootstrap records 
contents 84,92 
writing 
INIT 56 
REFORMAT 85 
IPL program 
maximum sizes by device type 
CINIT) 55 
CREFORMAT) 8&3 
reformatting to add, 
example CREFORMAT) 86 
Writing a user-supplied 
CINIT) 55-57 
writing a user-supplied 
CREFORMAT) 83-85 
IXVTOC CIndexed VTOC) 41 


job control language, to execute 
Device Support Facilities 
program 14,15 
JOB statement, executing Device 
Support Facilities 
in OS/VS 14 
in DOS/VSE 16 
JOBCAT DD statement, executing Device 
Support Facilities 15 


[| 
labels, writing over user-volume 


CREFORMAT) 81 
legend of a volume map 89 
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level of ICKDSF 3 
line continuations 23 
load module, location of 9 
loading the Device Support 
Facilities, specifying date 
and time of day 12 
loading the Device Support 
Facilities program 11 
identifying the console 12 
identifying the input device 12 
identifying the output device 13 
location, volume table of contents, 
specifying CINIT) 51-52 
laecation, VTOQC index, 
specifying CINIT) 53 


main storage requirements 3 
map | 
example 89 
printing 
INIT 59 
INSPECT 71 | 
MAPALT command 76-79 
description 7,76 
examples 79 
syntax 77 


VIXM 157 
VMDS 157 
VPSM 157 


maximal lavel initialization 46 
in a stand-alone environment, 
example CINIT) 60 
maximum sizes for IPL program 
by device type 
INIT 55 
REFORMAT. 83 
maximum sizes for VTOC and 
VTOC index, table 158 
medial level initialization 46 
in a stand-alone environment, 
example CINIT) 66 
messages, Device Support Facilities, 
Appendix © ICK 96-136 | 
MIMIC parameter 


INIT 58 
restriction 49 
INSPECT 72 
restriction 69 
minidisk 


description of support 
Appendix B 95 
initializing in a stand-alone 
environment, examples 
INIT 61 | 
inspecting in a stand-alone 
environment, examples 
INSPECT 74 
specifying 
INIT 58 
INSPECT 72 | | 
minimal level initialization 45 
for the first time in offline 
mode €OS/VS), example CINIT) 59 
movable head error table 
CANALYZE) 33,37 


new volume serial number, specifying 

CREFORMAT?) 82 : 
NOASSIGN parameter, CINSPECT) 72 
null THEN and ELSE clauses 19 


offline mode 
data set security and 
protection & 
initializing a volume at medial 
level as Mass Storage System 
staging pack, example (INIT) 61 | 
initializing a volume for the first 
time, example CINIT) 59 
initializing two volumes, example 
CINIT) 61 
inspecting a volume for 
unconditional assignment of 
alternate tracks, 
example CINSPECT) 73 
inspecting a volume to reclaim 
tracks, example CINSPECT) 74 
reformatting to change the volume 
serial number, examples 
CREFORMAT) 8&5 
online mode (OS/V5) 
data set security and 
protection 
initializing a volume at the 
minimal level, example CINIT) 60 
inspecting a volume for conditional 
asstdnment of alternate 
tracks, example CINSPECT) 73 
reformatting a volume to add an IPL 
program, example (REFORMAT) 8&6 
OSVTOC (0S format VTOC) 41 
output devices supported in stand- 
alone environment, list of 13 
output printer, messages received at, 
Appendix C ICK 96-136 
owner identification 
specifying CINIT) 54 
verifying 
INIT 48 
INSPECT 68 
REFORMAT 80 


parameters 
abbreviating 23 
ALL, MAPALT 78 
ALLTRACKS, INSPECT 67 
ASSIGN, INSPECT 72 


BLOCKS 68 
BOOTSTRAP 
INIT 57 
REFORMAT 85 
CHECK 
INIT 50 
INSPECT 69 
Values 164 
DDNAME 
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ANALYZE 28 


BUILDIX 40 
INIT 47 
INSPECT 67 


REFORMAT 80 
DETAIL, MAPALT 78 
DEVICETYPE 

INIT 48 

INSPECT 69 
DOSVTOC, INIT 52 
FBAVTOC, INIT 52 
INDEX, INIT 53 
IPLDD 

INIT 55 

REFORMAT 83 
LABELS, INIT 54 
LIMITS 

ANALYZE 29 

MAPALT 78 


INIT 


restriction 49,95 


INSPECT 72 
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